Obtiene todas las delegaciones de subred disponibles para esta suscripción en esta región.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{location}/availableDelegations?api-version=2024-05-01
Parámetros de identificador URI
Nombre |
En |
Requerido |
Tipo |
Description |
location
|
path |
True
|
string
|
Ubicación de la subred.
|
subscriptionId
|
path |
True
|
string
|
Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI de cada llamada de servicio.
|
api-version
|
query |
True
|
string
|
Versión de la API de cliente.
|
Respuestas
Nombre |
Tipo |
Description |
200 OK
|
AvailableDelegationsResult
|
Solicitud correcta. Devuelve todas las posibles delegaciones de una subred de esta suscripción en la región.
|
Other Status Codes
|
CloudError
|
Respuesta de error que describe por qué se produjo un error en la operación.
|
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory.
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
Nombre |
Description |
user_impersonation
|
suplantar la cuenta de usuario
|
Ejemplos
Get available delegations
Solicitud de ejemplo
GET https://management.azure.com/subscriptions/subId/providers/Microsoft.Network/locations/westcentralus/availableDelegations?api-version=2024-05-01
/**
* Samples for AvailableDelegations List.
*/
public final class Main {
/*
* x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2024-05-01/examples/
* AvailableDelegationsSubscriptionGet.json
*/
/**
* Sample code: Get available delegations.
*
* @param azure The entry point for accessing resource management APIs in Azure.
*/
public static void getAvailableDelegations(com.azure.resourcemanager.AzureResourceManager azure) {
azure.networks().manager().serviceClient().getAvailableDelegations().list("westcentralus",
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.network import NetworkManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-network
# USAGE
python available_delegations_subscription_get.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 = NetworkManagementClient(
credential=DefaultAzureCredential(),
subscription_id="subId",
)
response = client.available_delegations.list(
location="westcentralus",
)
for item in response:
print(item)
# x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2024-05-01/examples/AvailableDelegationsSubscriptionGet.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 armnetwork_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/network/armnetwork/v6"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/ab04533261eff228f28e08900445d0edef3eb70c/specification/network/resource-manager/Microsoft.Network/stable/2024-05-01/examples/AvailableDelegationsSubscriptionGet.json
func ExampleAvailableDelegationsClient_NewListPager() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armnetwork.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
pager := clientFactory.NewAvailableDelegationsClient().NewListPager("westcentralus", 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.AvailableDelegationsResult = armnetwork.AvailableDelegationsResult{
// Value: []*armnetwork.AvailableDelegation{
// {
// Name: to.Ptr("Microsoft.Provider.resourceType"),
// Type: to.Ptr("Microsoft.Network/availableDelegations"),
// Actions: []*string{
// to.Ptr("Microsoft.Network/resource/action")},
// ID: to.Ptr("/subscriptions/subId/providers/Microsoft.Network/availableDelegations/Microsoft.Provider.resourceType"),
// ServiceName: to.Ptr("Microsoft.Provider/resourceType"),
// }},
// }
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Gets all of the available subnet delegations for this subscription in this region.
*
* @summary Gets all of the available subnet delegations for this subscription in this region.
* x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2024-05-01/examples/AvailableDelegationsSubscriptionGet.json
*/
async function getAvailableDelegations() {
const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subId";
const location = "westcentralus";
const credential = new DefaultAzureCredential();
const client = new NetworkManagementClient(credential, subscriptionId);
const resArray = new Array();
for await (let item of client.availableDelegations.list(location)) {
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
Respuesta de muestra
{
"value": [
{
"name": "Microsoft.Provider.resourceType",
"id": "/subscriptions/subId/providers/Microsoft.Network/availableDelegations/Microsoft.Provider.resourceType",
"type": "Microsoft.Network/availableDelegations",
"serviceName": "Microsoft.Provider/resourceType",
"actions": [
"Microsoft.Network/resource/action"
]
}
]
}
Definiciones
AvailableDelegation
El serviceName de una propiedad AvailableDelegation indica una posible delegación para una subred.
Nombre |
Tipo |
Description |
actions
|
string[]
|
Las acciones permitidas para el servicio tras la delegación.
|
id
|
string
|
Identificador único del recurso AvailableDelegation.
|
name
|
string
|
Nombre del recurso AvailableDelegation.
|
serviceName
|
string
|
Nombre del servicio y el recurso.
|
type
|
string
|
Tipo de recurso.
|
AvailableDelegationsResult
Una matriz de delegaciones disponibles.
Nombre |
Tipo |
Description |
nextLink
|
string
|
Dirección URL para obtener el siguiente conjunto de resultados.
|
value
|
AvailableDelegation[]
|
Una matriz de delegaciones disponibles.
|
CloudError
Respuesta de error del servicio.
Nombre |
Tipo |
Description |
error
|
CloudErrorBody
|
Cuerpo del error en la nube.
|
CloudErrorBody
Respuesta de error del servicio.
Nombre |
Tipo |
Description |
code
|
string
|
Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
|
details
|
CloudErrorBody[]
|
Lista de detalles adicionales sobre el error.
|
message
|
string
|
Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
|
target
|
string
|
Destino del error concreto. Por ejemplo, el nombre de la propiedad en error.
|