ar ar ar ar ar ar ar ar ar ar ar ar en ar ar ar ar ar ar ar ar ar ar ar ar ar ar ar ar ar ar ar ar ar ar en ar ar en ar ar en ar ar ar ar hu ar ar ar ar ar ar ar uk ar ar ar ar ar ar ar ar ar ar ar ar ar ar ur ar ar ar ar ar ar ar ar en ar ar ur ar ar ar ar ar ar ar ar en
ينطبق على: واجهة برمجة تطبيقاتSQL وواجهة برمجة تطبيقات Cassandra وواجهة برمجة تطبيقات Gremlin وواجهة برمجة تطبيقات Table وواجهة برمجة تطبيقات Azure Cosmos DB لـ MongoDB
يوضح البرنامج النصي في هذه المقالة توصيل حساب Azure Cosmos موجود بشبكة ظاهرية جديدة حالية حيث لم يتم تكوين الشبكة الفرعية بعد لنقاط نهاية الخدمة باستخدام المعلمة ignore-missing-vnet-service-endpoint. يسمح ذلك بإكمال تكوين حساب Cosmos بدون أخطاء قبل اكتمال تكوين الشبكة الفرعية للشبكة الافتراضية. بمجرد اكتمال تكوين الشبكة الفرعية، يمكن الوصول إلى حساب Cosmos من خلال الشبكة الفرعية المكونة.
يستخدم هذا البرنامج النصي حساب SQL (Core) API. لاستخدام هذا النموذج لواجهات برمجة التطبيقات الأخرى، قم بتطبيق معلمات enable-virtual-network وvirtual-network-rules في النص البرمجي أدناه على النص البرمجي المحدد لواجهة برمجة التطبيقات.
إذا لم يكن لديك اشتراك Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.
يمكنك استخدام Azure Cloud Shell أو Azure CLI محلي.
Azure Cloud Shell مع بيئة Bash. أو قم بتشغيل Cloud Shell هنا.
Azure CLI المحلي، راجع كيفية تثبيت Azure CLI. إذا كنت تعمل على Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.
قم بتسجيل الدخول إلى CLI Azure باستخدام az login. لإنهاء عملية المصادقة، التزم بالخطوات المعروضة في وحدتك الطرفية. للحصول على خيارات أخرى لتسجيل دخول، راجع تسجيل الدخول باستخدام Azure CLI.
عند استخدام Azure CLI لأول مرة، قم بتثبيت ملحق Azure CLI. لمزيد من المعلومات بشأن الامتدادات، راجع استخدام امتدادات مع Azure CLI.
يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.
تتطلب هذه المقالة الإصدار 2.9.1 أو أحدث من CLI Azure. إذا كنت تستخدم Azure Cloud Shell، يتم تثبيت أحدث إصدار بالفعل.
تشغيل Azure Cloud Shell
Azure Cloud Shell عبارة عن واجهة تفاعلية مجانية يُمكنك استخدامها لتنفيذ الخطوات الواردة في هذه المقالة. يحتوي على أدوات Azure الشائعة والمثبتة مسبقاً والتي تم تكوينها للاستخدام مع حسابك.
لفتح Cloud Shell، ما عليك سوى تحديد "Try it" من الزاوية العليا اليسرى لكتلة التعليمة البرمجية. يمكنك أيضاً تشغيل Cloud Shell في علامة تبويب مستعرض منفصلة بالانتقال إلى https://shell.azure.com.
عند فتح Cloud Shell، تحقق من تحديد Bash لبيئتك. ستستخدم الجلسات اللاحقة Azure CLI في بيئة Bash، حدد نسخ لنسخ كتل التعليمة البرمجية، وألصقها في Cloud Shell، واضغط على Enter لتشغيلها.
تسجيل الدخول إلى Azure
يُصادق Cloud Shell تلقائياً بموجب الحساب الأولي الذي سُجل الدخول به. استخدم البرنامج النصي التالي لتسجيل الدخول باستخدام اشتراك مختلف، واستبدل   بمعرّف اشتراك Azure الخاص بك. إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.
subscription=" " # add subscription here az account set -s $subscription # ...or use 'az login'
لمزيد من المعلومات، راجع تعيين اشتراك نشط أو تسجيل الدخول بشكل تفاعلي
# Service endpoint operations for an Azure Cosmos account Variable block let "randomIdentifier=$RANDOM*$RANDOM" location="East US" resourceGroup="msdocs-cosmosdb-rg-$randomIdentifier" tag="service-endpoints-cosmosdb" account="msdocs-account-cosmos-$randomIdentifier" #needs to be lower case vNet='msdocs-vnet-cosmosdb' frontEnd='msdocs-front-end-cosmosdb' backEnd='msdocs-back-end-cosmosdb' # Create a resource group echo "Creating $resourceGroup in $location..." az group create --name $resourceGroup --location "$location" --tags $tag # Create a virtual network with a front-end subnet echo "Creating $vnet" az network vnet create --name $vNet --resource-group $resourceGroup --address-prefix 10.0.0.0/16 --subnet-name $frontEnd --subnet-prefix 10.0.1.0/24 # Create a back-end subnet but without specifying --service-endpoints Microsoft.AzureCosmosDB echo "Creating $backend in $vNet" az network vnet subnet create --name $backEnd --resource-group $resourceGroup --address-prefix 10.0.2.0/24 --vnet-name $vNet # Retrieve the value of the service endpoint svcEndpoint=$(az network vnet subnet show --resource-group $resourceGroup --name $backEnd --vnet-name $vNet --query 'id' -o tsv) # Create a Cosmos DB account with default values # Use appropriate values for --kind or --capabilities for other APIs echo "Creating $account for CosmosDB" az cosmosdb create --name $account --resource-group $resourceGroup --enable-virtual-network # Add the virtual network rule but ignore the missing service endpoint on the subnet az cosmosdb network-rule add --name $account --resource-group $resourceGroup --virtual-network $vNet --subnet $svcEndpoint --ignore-missing-vnet-service-endpoint true # Update vNet update az network vnet subnet update --name $backEnd --resource-group $resourceGroup --vnet-name $vNet --service-endpoints Microsoft.AzureCosmosDB
استخدم الأمر التالي لإزالة مجموعة الموارد وجميع الموارد المقترنة بها باستخدام الأمر حذف مجموعة az - إلا إذا وُجدت حاجة مستمرة لهذه الموارد. قد يستغرق إنشاء بعض هذه الموارد بعض الوقت، وكذلك حذفها.