Rövid útmutató: Egyéni Azure-erőforrás-szolgáltató létrehozása és egyéni erőforrások üzembe helyezése

Ebben a rövid útmutatóban létrehoz egy egyéni erőforrás-szolgáltatót, és egyéni erőforrásokat helyez üzembe az adott erőforrás-szolgáltatóhoz. Az egyéni erőforrás-szolgáltatókkal kapcsolatos további információkért tekintse meg az Azure Custom Resource Providers áttekintését.

Előfeltételek

• Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.
• A rövid útmutató lépéseinek elvégzéséhez meg kell hívnia REST a műveleteket. A REST-kérések küldésének különböző módjai vannak.

Azure CLI

A környezet előkészítése az Azure CLI-re.

• Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.

  

• Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.

  • Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.

  • Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.

  • Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.

Az Azure CLI-példák a kérésekhez használhatók az restREST . További információ: az rest.

PowerShell

• A PowerShell-parancsok helyileg futnak a PowerShell 7 vagy újabb verziójával, valamint az Azure PowerShell-modulokkal. További információ: Az Azure PowerShell telepítése.
• Ha még nincs eszköze a műveletekhez REST , telepítse az ARMClientet. Ez egy nyílt forráskódú parancssori eszköz, amely leegyszerűsíti az Azure Resource Manager API meghívását.
• Az ARMClient telepítése után a powershell-parancssorból megjelenítheti a használati adatokat a következő beírással: armclient.exe. Vagy nyissa meg az ARMClient wikit.

Egyéni erőforrás-szolgáltató üzembe helyezése

Az egyéni erőforrás-szolgáltató beállításához helyezzen üzembe egy példasablont az Azure-előfizetésében.

A sablon a következő erőforrásokat helyezi üzembe az előfizetésében:

• Függvényalkalmazás az erőforrások és műveletek műveleteivel.
• Tárfiók az egyéni erőforrás-szolgáltatón keresztül létrehozott felhasználók tárolásához.
• Egyéni erőforrás-szolgáltató, amely meghatározza az egyéni erőforrástípusokat és -műveleteket. A függvényalkalmazás végpontját használja a kérések küldéséhez.
• Egyéni erőforrás az egyéni erőforrás-szolgáltatótól.

Az egyéni erőforrás-szolgáltató üzembe helyezéséhez használja az Azure CLI-t, a PowerShellt vagy az Azure Portalt.

Azure CLI

Ez a példa arra kéri, hogy adja meg az erőforráscsoport, a hely és a szolgáltató függvényalkalmazásának nevét. A nevek más parancsokban használt változókban vannak tárolva. Az az group create és az az deployment group create parancsok üzembe helyezik az erőforrásokat.

read -p "Enter a resource group name:" rgName &&
read -p "Enter the location (i.e. eastus):" location &&
read -p "Enter the provider's function app name:" funcName &&
templateUri="https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/custom-providers/customprovider.json" &&
az group create --name $rgName --location "$location" &&
az deployment group create --resource-group $rgName --template-uri $templateUri --parameters funcName=$funcName &&
echo "Press [ENTER] to continue ..." &&
read

PowerShell

Ez a példa arra kéri, hogy adja meg az erőforráscsoport, a hely és a szolgáltató függvényalkalmazásának nevét. A nevek más parancsokban használt változókban vannak tárolva. A New-AzResourceGroup és a New-AzResourceGroupDeployment parancsok telepítik az erőforrásokat.

$rgName = Read-Host -Prompt "Enter a resource group name"
$location = Read-Host -Prompt "Enter the location (i.e. eastus)"
$funcName = Read-Host -Prompt "Enter the provider's function app name"
$templateUri = "https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/custom-providers/customprovider.json"
New-AzResourceGroup -Name $rgName -Location "$location"
New-AzResourceGroupDeployment -ResourceGroupName $rgName -TemplateUri $templateUri -funcName $funcName
Read-Host -Prompt "Press [ENTER] to continue ..."

Ha a sablont az Azure Portalról szeretné üzembe helyezni, válassza az Üzembe helyezés az Azure-ban gombot.

Egyéni erőforrás-szolgáltató és -erőforrás megtekintése

A portálon az egyéni erőforrás-szolgáltató rejtett erőforrástípus. Az erőforrás-szolgáltató üzembe helyezésének ellenőrzéséhez lépjen az erőforráscsoportra, és válassza a Rejtett típusok megjelenítése lehetőséget.

Az üzembe helyezett egyéni erőforrás megtekintéséhez használja az GET erőforrástípuson található műveletet. A JSON-válaszban látható erőforrástípus Microsoft.CustomProviders/resourceProviders/users tartalmazza a sablon által létrehozott erőforrást.

GET https://management.azure.com/subscriptions/<sub-id>/resourceGroups/<rg-name>/providers/Microsoft.CustomProviders/resourceProviders/<provider-name>/users?api-version=2018-09-01-preview

Azure CLI

subID=$(az account show --query id --output tsv)
requestURI="https://management.azure.com/subscriptions/$subID/resourceGroups/$rgName/providers/Microsoft.CustomProviders/resourceProviders/$funcName/users?api-version=2018-09-01-preview"
az rest --method get --uri $requestURI

A következő választ kapja:

{
  "value": [
    {
      "id": "/subscriptions/<sub-id>/resourceGroups/<rg-name>/providers/Microsoft.CustomProviders/resourceProviders/<provider-name>/users/ana",
      "name": "ana",
      "properties": {
        "FullName": "Ana Bowman",
        "Location": "Moon",
        "provisioningState": "Succeeded"
      },
      "type": "Microsoft.CustomProviders/resourceProviders/users"
    }
  ]
}

PowerShell

$subID = (Get-AzContext).Subscription.Id
$requestURI = "https://management.azure.com/subscriptions/$subID/resourceGroups/$rgName/providers/Microsoft.CustomProviders/resourceProviders/$funcName/users?api-version=2018-09-01-preview"

armclient GET $requestURI

A következő választ kapja:

{
  "value": [
    {
      "properties": {
        "provisioningState": "Succeeded",
        "FullName": "Ana Bowman",
        "Location": "Moon"
      },
      "id": "/subscriptions/<sub-id>/resourceGroups/<rg-name>/providers/Microsoft.CustomProviders/resourceProviders/<provider-name>/users/ana",
      "name": "ana",
      "type": "Microsoft.CustomProviders/resourceProviders/users"
    }
  ]
}

Hívási művelet

Az egyéni erőforrás-szolgáltatónak is van egy művelete.ping A kérést feldolgozó kód implementálva van a függvényalkalmazásban. A ping művelet üdvözléssel válaszol.

A kérés elküldéséhez ping használja a POST művelet műveletét.

POST https://management.azure.com/subscriptions/<sub-id>/resourceGroups/<rg-name>/providers/Microsoft.CustomProviders/resourceProviders/<provider-name>/ping?api-version=2018-09-01-preview

Azure CLI

pingURI="https://management.azure.com/subscriptions/$subID/resourceGroups/$rgName/providers/Microsoft.CustomProviders/resourceProviders/$funcName/ping?api-version=2018-09-01-preview"
az rest --method post --uri $pingURI

A következő választ kapja:

{
  "message": "hello <function-name>.azurewebsites.net",
  "pingcontent": {
    "source": "<function-name>.azurewebsites.net"
  }
}

PowerShell

$pingURI = "https://management.azure.com/subscriptions/$subID/resourceGroups/$rgName/providers/Microsoft.CustomProviders/resourceProviders/$funcName/ping?api-version=2018-09-01-preview"

armclient POST $pingURI

A következő választ kapja:

{
  "pingcontent": {
    "source": "<function-name>.azurewebsites.net"
  },
  "message": "hello <function-name>.azurewebsites.net"
}

Erőforrás létrehozása a PUT használatával

Ebben a rövid útmutatóban a sablon az erőforrástípust Microsoft.CustomProviders/resourceProviders/users használta egy erőforrás üzembe helyezéséhez. Egy művelettel PUT is létrehozhat egy erőforrást. Ha például egy erőforrás nincs üzembe helyezve a sablonnal, a PUT művelet létrehoz egy erőforrást.

Ebben a példában, mivel a sablon már üzembe helyezett egy erőforrást, a PUT művelet létrehoz egy új erőforrást.

PUT https://management.azure.com/subscriptions/<sub-id>/resourceGroups/<rg-name>/providers/Microsoft.CustomProviders/resourceProviders/<provider-name>/users/<resource-name>?api-version=2018-09-01-preview

{"properties":{"FullName": "Test User", "Location": "Earth"}}

Azure CLI

addURI="https://management.azure.com/subscriptions/$subID/resourceGroups/$rgName/providers/Microsoft.CustomProviders/resourceProviders/$funcName/users/testuser?api-version=2018-09-01-preview"
az rest --method put --uri $addURI --body "{'properties':{'FullName': 'Test User', 'Location': 'Earth'}}"

A következő választ kapja:

{
  "id": "/subscriptions/<sub-ID>/resourceGroups/<rg-name>/providers/Microsoft.CustomProviders/resourceProviders/<provider-name>/users/testuser",
  "name": "testuser",
  "properties": {
    "FullName": "Test User",
    "Location": "Earth",
    "provisioningState": "Succeeded"
  },
  "type": "Microsoft.CustomProviders/resourceProviders/users"
}

PowerShell

$addURI = "https://management.azure.com/subscriptions/$subID/resourceGroups/$rgName/providers/Microsoft.CustomProviders/resourceProviders/$funcName/users/testuser?api-version=2018-09-01-preview"
$requestBody = "{'properties':{'FullName': 'Test User', 'Location': 'Earth'}}"

armclient PUT $addURI $requestBody

A következő választ kapja:

{
  "properties": {
    "provisioningState": "Succeeded",
    "FullName": "Test User",
    "Location": "Earth"
  },
  "id": "/subscriptions/<sub-ID>/resourceGroups/<rg-name>/providers/Microsoft.CustomProviders/resourceProviders/<provider-name>/users/testuser",
  "name": "testuser",
  "type": "Microsoft.CustomProviders/resourceProviders/users"
}

A műveletet újrafuttathatja az GETegyéni erőforrás-szolgáltató megtekintése és az erőforrás szakaszból a létrehozott két erőforrás megjelenítéséhez. Ez a példa az Azure CLI-parancs kimenetét mutatja be.

{
  "value": [
    {
      "id": "/subscriptions/<sub-id>/resourceGroups/<rg-name>/providers/Microsoft.CustomProviders/resourceProviders/<provider-name>/users/ana",
      "name": "ana",
      "properties": {
        "FullName": "Ana Bowman",
        "Location": "Moon",
        "provisioningState": "Succeeded"
      },
      "type": "Microsoft.CustomProviders/resourceProviders/users"
    },
    {
      "id": "/subscriptions/<sub-id>/resourceGroups/<rg-name>/providers/Microsoft.CustomProviders/resourceProviders/<provider-name>/users/testuser",
      "name": "testuser",
      "properties": {
        "FullName": "Test User",
        "Location": "Earth",
        "provisioningState": "Succeeded"
      },
      "type": "Microsoft.CustomProviders/resourceProviders/users"
    }
  ]
}

Egyéni erőforrás-szolgáltatói parancsok

Használja az egyéni szolgáltatók parancsait az egyéni erőforrás-szolgáltatóval való együttműködéshez.

Egyéni erőforrás-szolgáltatók listázása

list A paranccsal megjelenítheti az előfizetés összes egyéni erőforrás-szolgáltatóját. Az alapértelmezett lista az aktuális előfizetés egyéni erőforrás-szolgáltatóit tartalmazza, vagy megadhatja a paramétert --subscription . Erőforráscsoport listázásához használja a paramétert --resource-group .

az custom-providers resource-provider list --subscription $subID

[
  {
    "actions": [
      {
        "endpoint": "https://<provider-name>.azurewebsites.net/api/{requestPath}",
        "name": "ping",
        "routingType": "Proxy"
      }
    ],
    "id": "/subscriptions/<sub-id>/resourceGroups/<rg-name>/providers/Microsoft.CustomProviders/resourceproviders/<provider-name>",
    "location": "eastus",
    "name": "<provider-name>",
    "provisioningState": "Succeeded",
    "resourceGroup": "<rg-name>",
    "resourceTypes": [
      {
        "endpoint": "https://<provider-name>.azurewebsites.net/api/{requestPath}",
        "name": "users",
        "routingType": "Proxy, Cache"
      }
    ],
    "tags": {},
    "type": "Microsoft.CustomProviders/resourceproviders",
    "validations": null
  }
]

A tulajdonságok megjelenítése

show A parancs használatával megjelenítheti az egyéni erőforrás-szolgáltató tulajdonságait. A kimeneti formátum hasonlít a kimenetre list .

az custom-providers resource-provider show --resource-group $rgName --name $funcName

Új erőforrás létrehozása

create A parancs használatával egyéni erőforrás-szolgáltatót hozhat létre vagy frissíthet. Ez a példa frissíti az és resourceTypesa actions .

az custom-providers resource-provider create --resource-group $rgName --name $funcName \
--action name=ping endpoint=https://myTestSite.azurewebsites.net/api/{requestPath} routing_type=Proxy \
--resource-type name=users endpoint=https://myTestSite.azurewebsites.net/api/{requestPath} routing_type="Proxy, Cache"

"actions": [
  {
    "endpoint": "https://myTestSite.azurewebsites.net/api/{requestPath}",
    "name": "ping",
    "routingType": "Proxy"
  }
],

"resourceTypes": [
  {
    "endpoint": "https://myTestSite.azurewebsites.net/api/{requestPath}",
    "name": "users",
    "routingType": "Proxy, Cache"
  }
],

A szolgáltató címkéinek frissítése

A update parancs csak az egyéni erőforrás-szolgáltató címkéinek frissítésére használható. Az Azure Portalon az egyéni erőforrás-szolgáltató appszolgáltatása megjeleníti a címkét.

az custom-providers resource-provider update --resource-group $rgName --name $funcName --tags new=tag

"tags": {
  "new": "tag"
},

Egyéni erőforrás-szolgáltató törlése

A delete parancssor csak az egyéni erőforrás-szolgáltatót kéri és törli. A tárfiók, az App Service és az App Service-csomag nem törlődik. A szolgáltató törlése után a rendszer visszalép egy parancssorba.

az custom-providers resource-provider delete --resource-group $rgName --name $funcName

Az erőforrások eltávolítása

Ha végzett a cikkben létrehozott erőforrásokkal, törölheti az erőforráscsoportot. Egy erőforráscsoport törlésekor az adott erőforráscsoport összes erőforrása törlődik.

Azure CLI

az group delete --resource-group $rgName

PowerShell

Remove-AzResourceGroup -Name $rgName

Következő lépések

Az egyéni erőforrás-szolgáltatókról az alábbi cikkben olvashat bővebben:

Az Azure egyéni erőforrás-szolgáltatóinak áttekintése