Felsorolja azokat az Azure-régiókat, amelyekben a szolgáltatás létezik.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/regions?api-version=2022-08-01
URI-paraméterek
Name |
In |
Kötelező |
Típus |
Description |
resourceGroupName
|
path |
True
|
string
|
Az erőforráscsoport neve. A név megkülönbözteti a kis- és nagybetűket.
|
serviceName
|
path |
True
|
string
|
A API Management szolgáltatás neve.
Regex pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$
|
subscriptionId
|
path |
True
|
string
|
A cél-előfizetés azonosítója.
|
api-version
|
query |
True
|
string
|
A művelethez használandó API-verzió.
|
Válaszok
Name |
Típus |
Description |
200 OK
|
RegionListResult
|
Azoknak a régióknak a listája, amelyekben a szolgáltatás üzembe van helyezve.
|
Other Status Codes
|
ErrorResponse
|
Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.
|
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name |
Description |
user_impersonation
|
felhasználói fiók megszemélyesítése
|
Példák
ApiManagementListRegions
Sample Request
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/regions?api-version=2022-08-01
/** Samples for Region ListByService. */
public final class Main {
/*
* x-ms-original-file: specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementListRegions.json
*/
/**
* Sample code: ApiManagementListRegions.
*
* @param manager Entry point to ApiManagementManager.
*/
public static void apiManagementListRegions(com.azure.resourcemanager.apimanagement.ApiManagementManager manager) {
manager.regions().listByService("rg1", "apimService1", com.azure.core.util.Context.NONE);
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.apimanagement import ApiManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-apimanagement
# USAGE
python api_management_list_regions.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = ApiManagementClient(
credential=DefaultAzureCredential(),
subscription_id="subid",
)
response = client.region.list_by_service(
resource_group_name="rg1",
service_name="apimService1",
)
for item in response:
print(item)
# x-ms-original-file: specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementListRegions.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armapimanagement_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/apimanagement/armapimanagement/v2"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/4cd95123fb961c68740565a1efcaa5e43bd35802/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementListRegions.json
func ExampleRegionClient_NewListByServicePager() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armapimanagement.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
pager := clientFactory.NewRegionClient().NewListByServicePager("rg1", "apimService1", nil)
for pager.More() {
page, err := pager.NextPage(ctx)
if err != nil {
log.Fatalf("failed to advance page: %v", err)
}
for _, v := range page.Value {
// You could use page here. We use blank identifier for just demo purposes.
_ = v
}
// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// page.RegionListResult = armapimanagement.RegionListResult{
// Count: to.Ptr[int64](1),
// Value: []*armapimanagement.RegionContract{
// {
// Name: to.Ptr("West US"),
// IsDeleted: to.Ptr(false),
// IsMasterRegion: to.Ptr(true),
// }},
// }
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { ApiManagementClient } = require("@azure/arm-apimanagement");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Lists all azure regions in which the service exists.
*
* @summary Lists all azure regions in which the service exists.
* x-ms-original-file: specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementListRegions.json
*/
async function apiManagementListRegions() {
const subscriptionId = process.env["APIMANAGEMENT_SUBSCRIPTION_ID"] || "subid";
const resourceGroupName = process.env["APIMANAGEMENT_RESOURCE_GROUP"] || "rg1";
const serviceName = "apimService1";
const credential = new DefaultAzureCredential();
const client = new ApiManagementClient(credential, subscriptionId);
const resArray = new Array();
for await (let item of client.region.listByService(resourceGroupName, serviceName)) {
resArray.push(item);
}
console.log(resArray);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Sample Response
{
"value": [
{
"name": "West US",
"isMasterRegion": true,
"isDeleted": false
}
],
"count": 1,
"nextLink": ""
}
Definíciók
ErrorFieldContract
Hibamező-szerződés.
Name |
Típus |
Description |
code
|
string
|
Tulajdonságszintű hibakód.
|
message
|
string
|
A tulajdonságszintű hiba emberi olvasásra alkalmas ábrázolása.
|
target
|
string
|
Tulajdonság neve.
|
ErrorResponse
Hibaválasz.
Name |
Típus |
Description |
error.code
|
string
|
Szolgáltatás által definiált hibakód. Ez a kód a válaszban megadott HTTP-hibakód alállapotaként szolgál.
|
error.details
|
ErrorFieldContract[]
|
Érvényesítési hiba esetén az érvénytelen mezők listája küldi el a kérést.
|
error.message
|
string
|
A hiba emberi olvasásra alkalmas ábrázolása.
|
RegionContract
Régióprofil.
Name |
Típus |
Description |
isDeleted
|
boolean
|
azt jelzi, hogy a régió törölve van-e.
|
isMasterRegion
|
boolean
|
azt jelzi, hogy a Régió a főrégió-e.
|
name
|
string
|
Régió neve.
|
RegionListResult
Felsorolja a Régiók művelet válaszának részleteit.
Name |
Típus |
Description |
count
|
integer
|
Összes rekordszám az összes oldalon.
|
nextLink
|
string
|
Ha van ilyen, a következő oldal hivatkozása.
|
value
|
RegionContract[]
|
Régiók listája.
|