Partager via

Batch Account - List Outbound Network Dependencies Endpoints

  • Référence
Service:
Batch Management
Version d'API:
2024-07-01

Répertorie les points de terminaison qu’un nœud de calcul Batch sous ce compte Batch peut appeler dans le cadre de l’administration du service Batch. Si vous déployez un pool à l’intérieur d’un réseau virtuel que vous spécifiez, vous devez vous assurer que votre réseau autorise l’accès sortant à ces points de terminaison. L’impossibilité d’autoriser l’accès à ces points de terminaison peut entraîner l’inutilisable de Batch pour marquer les nœuds affectés. Pour plus d’informations sur la création d’un pool à l’intérieur d’un réseau virtuel, consultez https://learn.microsoft.com/azure/batch/batch-virtual-network.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/outboundNetworkDependenciesEndpoints?api-version=2024-07-01

Paramètres URI

Nom Dans Obligatoire Type Description
accountName
 path True

string

Nom du compte Batch.

Modèle d’expression régulière: ^[a-zA-Z0-9]+$
resourceGroupName
 path True

string

Nom du groupe de ressources qui contient le compte Batch.
subscriptionId
 path True

string

ID d’abonnement Azure. Il s’agit d’une chaîne au format GUID (par exemple, 000000000-0000-0000-0000-000000000000000000000)
api-version
 query True

string

Version de l’API à utiliser avec la requête HTTP.

Réponses

Nom Type Description
200 OK

OutboundEnvironmentEndpointCollection

L’opération a réussi. La réponse contient une liste de dépendances réseau sortantes.
Other Status Codes

CloudError

Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux de code d’authentification Microsoft Entra OAuth 2.0

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

ListOutboundNetworkDependencies

Exemple de requête

GET https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/outboundNetworkDependenciesEndpoints?api-version=2024-07-01

Exemple de réponse

Code d’état:
200 
{
  "value": [
    {
      "category": "Azure Batch",
      "endpoints": [
        {
          "domainName": "sampleacct.japaneast.batch.azure.com",
          "description": "Applicable to job manager tasks, tasks that use job scoped authentication, or any task that makes calls to Batch.",
          "endpointDetails": [
            {
              "port": 443
            }
          ]
        },
        {
          "domainName": "japaneast.service.batch.azure.com",
          "description": "Applicable to all Azure Batch pools.",
          "endpointDetails": [
            {
              "port": 443
            }
          ]
        }
      ]
    },
    {
      "category": "Azure Storage",
      "endpoints": [
        {
          "domainName": "autostorageaccountname.blob.core.windows.net",
          "description": "AutoStorage endpoint for this Batch account. Applicable to all Azure Batch pools under this account.",
          "endpointDetails": [
            {
              "port": 443
            }
          ]
        },
        {
          "domainName": "*.blob.core.windows.net",
          "description": "Applicable to all Azure Batch pools.",
          "endpointDetails": [
            {
              "port": 443
            }
          ]
        },
        {
          "domainName": "*.table.core.windows.net",
          "description": "Applicable to all Azure Batch pools.",
          "endpointDetails": [
            {
              "port": 443
            }
          ]
        },
        {
          "domainName": "*.queue.core.windows.net",
          "description": "Applicable to all Azure Batch pools.",
          "endpointDetails": [
            {
              "port": 443
            }
          ]
        }
      ]
    },
    {
      "category": "Microsoft Package Repository",
      "endpoints": [
        {
          "domainName": "packages.microsoft.com",
          "description": "Only applicable to pools containing a Mount Configuration. Learn about Mount Configurations in Batch at https://learn.microsoft.com/azure/batch/virtual-file-mount.",
          "endpointDetails": [
            {
              "port": 443
            }
          ]
        }
      ]
    },
    {
      "category": "Azure Key Vault",
      "endpoints": [
        {
          "domainName": "*.vault.azure.net",
          "description": "Only applicable to pools containing a Disk Encryption Configuration and whose VM size does not support encryption at host. Learn more about disk encryption in Azure Batch at https://learn.microsoft.com/azure/batch/disk-encryption. Learn more about encryption at host and supported VM sizes at https://learn.microsoft.com/azure/virtual-machines/disks-enable-host-based-encryption-portal.",
          "endpointDetails": [
            {
              "port": 443
            }
          ]
        }
      ]
    }
  ]
}

Définitions

Nom Description
CloudError

Réponse d’erreur du service Batch.
CloudErrorBody

Réponse d’erreur du service Batch.
EndpointDependency

Nom de domaine et détails de connexion utilisés pour accéder à une dépendance.
EndpointDetail

Détails sur la connexion entre le service Batch et le point de terminaison.
OutboundEnvironmentEndpoint

Collection de points de terminaison associés à partir du même service pour lequel le service Batch nécessite un accès sortant.
OutboundEnvironmentEndpointCollection

Valeurs retournées par l’opération Liste.

CloudError

Réponse d’erreur du service Batch.

Nom Type Description
error

CloudErrorBody

Corps de la réponse d’erreur.

CloudErrorBody

Réponse d’erreur du service Batch.

Nom Type Description
code

string

Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
details

CloudErrorBody[]

Liste des détails supplémentaires sur l’erreur.
message

string

Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.
target

string

Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur.

EndpointDependency

Nom de domaine et détails de connexion utilisés pour accéder à une dépendance.

Nom Type Description
description

string

Informations supplémentaires lisibles par l’homme sur la dépendance et le cas échéant.
domainName

string

Nom de domaine de la dépendance. Les noms de domaine peuvent être qualifiés complets ou contenir un caractère générique * .
endpointDetails

EndpointDetail[]

Liste des détails de connexion pour ce point de terminaison.

EndpointDetail

Détails sur la connexion entre le service Batch et le point de terminaison.

Nom Type Description
port

integer

Le port vers lequel un point de terminaison est connecté.

OutboundEnvironmentEndpoint

Collection de points de terminaison associés à partir du même service pour lequel le service Batch nécessite un accès sortant.

Nom Type Description
category

string

Type de service auquel le service Batch se connecte.
endpoints

EndpointDependency[]

Points de terminaison de ce service vers lequel le service Batch effectue des appels sortants.

OutboundEnvironmentEndpointCollection

Valeurs retournées par l’opération Liste.

Nom Type Description
nextLink

string

Jeton de continuation.
value

OutboundEnvironmentEndpoint[]

Collection de points de terminaison de dépendance réseau sortants retournés par l’opération de référencement.