La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

API d’orchestration du cloud

Contributeurs

API d’orchestration de cloud NetApp Service Engine prend en charge la connexion de Cloud volumes Services au moteur de service NetApp et leur fonctionnement à partir du moteur de service NetApp. Azure NetApp Files (ANF) et Google Cloud Platform (GCP) sont pris en charge pour les services Cloud volumes.

Les abonnements aux services Cloud volumes sont gérés en dehors du moteur de services NetApp. Les identifiants pertinents sont fournis à NetApp Service Engine pour permettre la connexion aux services cloud.

Cette section décrit les API pour :

  • Gestion des instances Cloud Volumes Service

  • Gestion des comptes Azure NetApp Files

  • Gestion des pools de capacité Azure NetApp Files

  • La gestion des volumes Azure NetApp Files

  • Gestion de Google Cloud volumes

Instances Cloud Volumes Service

Utilisez les méthodes répertoriées dans le tableau suivant pour récupérer et créer les instances Cloud Volumes Service.

Méthode HTTP Chemin Description

`GET'

/v2.1/cvs/instances

Récupère toutes les instances Cloud Volumes Service.

«POST»

/v2.1/cvs/instances

Créer de nouvelles instances Cloud Volumes Service.

`GET'

`/v2.1/cvs/instances/{id}'

Récupérer une instance Cloud Volumes Service par ID.

`GET'

/v2.1/anf/comptes

Récupérer les comptes Azure NetApp Files.

«POST»

/v2.1/anf/comptes

Créer des comptes Azure NetApp Files

`GET'

`/v2.1/anf/accounts/{id}'

Récupérez un compte Azure NetApp Files par ID.

`GET'

/v2.1/anf/pools

Récupère tous les pools de capacité.

«POST»

/v2.1/anf/pools

Créer un pool de capacité.

`GET'

`/v2.1/anf/pools/{id}'

Récupérez un pool de capacité Azure NetApp Files par ID.

Attributs des instances Cloud Volumes Service

Le tableau suivant répertorie les attributs de l’instance Cloud Volumes Service.

Attribut Type Description

`id'

Chaîne

Identifiant unique de l’instance Cloud Volumes Service.

`nom'

Chaîne

Nom de l’instance Cloud Volumes Service.

cc_working_env

Chaîne

Nom de l’environnement de travail dans Cloud Manager.

`cc_client_id'

Chaîne

ID service Auth0.

cc_refresh_token

Chaîne

Jeton d’actualisation Auth0.

`cc_account_id'

Chaîne

ID de compte Cloud Central.

`cc_account_name'

Chaîne

Nom du compte Cloud Central.

`cc_credentials_id'

Chaîne

ID de l’environnement de travail Cloud Centra.

`azure_client_id'

Chaîne

ID d’application (client). ID d’un directeur de service Active Directory que Cloud Manager peut utiliser pour l’authentification avec Azure Active Directory.

`azure_client_secret'

Chaîne

La valeur du secret client pour l’application principale du service.

`azure_tenant_id'

Chaîne

ID Azure Active Directory. Il s’agit également d’un ID de locataire.

`azure_subscription_id'

Chaîne

ID d’abonnement Azure Active Directory.

`subtenant_id'

Chaîne

ID du sous-locataire.

«balises»

Les paires clé-valeur.

Récupérez l’instance Cloud Volumes Service

Méthode HTTP Chemin Description Paramètres de trajectoire

`GET'

/v2.1/cvs/instances

Récupère les instances Cloud Volumes Service.

tenant_ID: (Facultatif) renvoie les instances Cloud Volumes Service appartenant au locataire spécifié. Voir aussi "Pagination commune" paramètres.

Paramètres de l’organisme requis: `aucun'

Récupérez l’instance Cloud Volumes Service par ID

Utilisez la méthode indiquée dans le tableau suivant pour récupérer une instance Cloud Volumes Service par son identifiant.

Méthode HTTP Chemin Description Paramètres

`GET'

`/v2.1/cvs/instances/{id}'

Récupérer une instance Cloud Volumes Service par ID.

ID (chaîne): l’identifiant unique de l’instance Cloud Volumes Service.

Attributs de corps de demande requis: `aucun'

Créer des instances Cloud Volumes Service

Utilisez la méthode indiquée dans le tableau suivant pour créer une nouvelle instance Cloud Volumes Service.

Méthode HTTP Chemin Description Paramètres

«POST»

/v2.1/cvs/instances

Créez une instance Cloud Volumes Service.

Aucune

Attributs de corps de la demande requis : `name, cc_working_env, cc_client_ID, cc_refresh_token, cc_account_ID, cc_account_name, azure_client_id, azure_client_secret, azure_tenant_id, azure_subscription_id, sous-tenant_id'

Exemple corps de la demande :

{
  "name": "instance1",
  "cc_working_env": "my-working-env",
  "cc_client_id": "Mu0V1ywgYteI6w1MbD15fKfVIUrNXGWC",
  "cc_refresh_token": "y1tMw3lNzE8JL9jtiE29oSRxOAzYu0cdnwS_2XhjQBr9G",
  "cc_account_id": "account-335jdf32",
  "cc_account_name": "my-account-name",
  "cc_credentials_id": "d336c449-aeb8-4bb3-af28-5b886c40dd00",
  "azure_client_id": "53ba6f2b-6d52-4f5c-8ae0-7adc20808854",
  "azure_client_secret": "NMubGVcDqkwwGnCs6fa01tqlkTisfUd4pBBYgcxxx=",
  "azure_tenant_id": "53ba6f2b-6d52-4f5c-8ae0-7adc20808854",
  "azure_subscription_id": "1933a261-d141-4c68-9d6c-13b607790910",
  "subtenant_id": "5d2fb0fb4f47df00015274e3",
  "tags": {
    "key1": "Value 1",
    "key2": "Value 2",
    "key3": "Value 3",
    "keyN": "Value N"
  }
}

Gestion des balises des instances Cloud Volumes Service

Utilisez la méthode indiquée dans le tableau suivant pour spécifier des balises pour l’instance nommée Cloud Volumes Service.

Méthode HTTP Chemin Description Paramètres

«POST»

/v2.1/cvs/instances/{id}/tags

Gestion des balises d’une instance Cloud Volumes Service

«ID (chaîne)»: L’identifiant unique de l’instance Cloud Volumes Service.

Attributs de corps de demande requis : `paires de valeur-clés'

Exemple corps de la demande :

{
  "env": "test"
}

Comptes Azure NetApp Files

Attributs des comptes Azure NetApp Files

Le tableau suivant répertorie les attributs des comptes Azure NetApp Files.

Attribut Type Description

`id'

Chaîne

Identifiant unique du compte Azure NetApp Files.

`nom'

Chaîne

Nom du compte Azure NetApp Files.

`groupe_source'

Chaîne

Le groupe de ressources Azure.

«emplacement»

Chaîne

Emplacement Azure (région/zone).

`cvs_instance_id'

Chaîne

Identifiant de l’instance Cloud Volumes Service.

«balises»

Les paires clé-valeur.

Récupérer les comptes Azure NetApp Files

Méthode HTTP Chemin Description Paramètres de trajectoire

`GET'

/v2.1/anf/comptes

Récupérer les comptes Azure NetApp Files.

subtenant_ID: (obligatoire) l’ID du sous-locataire auquel appartient le compte Azure NetApp Files. `tenant_ID:' (Facultatif) renvoie les comptes Azure NetApp Files appartenant au locataire spécifié. Voir aussi "Pagination commune" paramètres.

Paramètres de l’organisme requis: `aucun'

Récupérer le compte Azure NetApp Files par nom

Utilisez la méthode indiquée dans le tableau ci-dessous pour récupérer un compte Azure NetApp Files par nom.

Méthode HTTP Chemin Description Paramètres

`GET'

`/v2.1/anf/accounts/{name}'

Récupérez un compte Azure NetApp Files par nom.

nom (chaîne): (obligatoire) le nom du compte Azure NetApp Files. subtenant_ID (chaîne): (obligatoire) l’ID du sous-locataire auquel appartient le compte Azure NetApp Files.

Attributs de corps de demande requis: `aucun'

Créer des comptes Azure NetApp Files

Utilisez la méthode indiquée dans le tableau suivant pour créer un compte Azure NetApp Files.

Méthode HTTP Chemin Description Paramètres

«POST»

/v2.1/anf/comptes

Créez un nouveau compte Azure NetApp Files.

Aucune

Attributs de corps de la demande requis : `name, Resource_group, location, cvs_instance_ID'

Exemple corps de la demande :

{
  "name": "string",
  "resource_group": "string",
  "location": "string",
  "cvs_instance_id": "5d2fb0fb4f47df00015274e3",
  "tags": {
    "key1": "Value 1",
    "key2": "Value 2",
    "key3": "Value 3",
    "keyN": "Value N"
  }
}

Pools de capacité de Azure NetApp Files

Attributs des pools de capacité

Le tableau suivant répertorie les attributs de pool de capacité.

Attribut Type Description

`id'

Chaîne

Identifiant unique du pool de capacité.

`nom'

Chaîne

Nom du pool de capacité.

`groupe_source'

Chaîne

Le groupe de ressources Azure.

«emplacement»

Chaîne

Emplacement Azure (région/zone).

mettre

Entier

Taille du pool de capacité en To.

`niveau_service'

Chaîne

Le nom du niveau de service s’applique : Ultra, Premium ou Standard.

`anf_account_name'

Chaîne

Identifiant d’instance de compte Azure NetApp Files.

`subtenant_id'

Chaîne

ID du sous-locataire.

«balises»

Les paires clé-valeur.

Récupérer les pools de capacité

Méthode HTTP Chemin Description Paramètres de trajectoire

`GET'

/v2.1/anf/pools

Récupérer les pools de capacité.

subtenant_ID: (obligatoire) l’ID du sous-locataire auquel appartient le compte ANF. tenant_ID: (Facultatif) renvoie les pools de capacité appartenant au locataire spécifié. Voir aussi "Pagination commune" paramètres.

Paramètres de l’organisme requis: `aucun'

Exemple corps de la demande :

none

Récupérez le pool de capacité par nom

Utilisez la méthode indiquée dans le tableau suivant pour récupérer un pool de capacité par nom.

Méthode HTTP Chemin Description Paramètres

`GET'

`/v2.1/anf/pools/{name}'

Récupérez un pool de capacité par nom.

name (chaîne): (obligatoire) le nom unique du pool de capacité. subtenant_ID (chaîne): (obligatoire) l’ID du sous-locataire auquel appartient le pool de capacités.

Attributs de corps de demande requis: `aucun'

Créer des pools de capacité

Utilisez la méthode indiquée dans le tableau suivant pour créer un nouveau pool de capacité.

Méthode HTTP Chemin Description Paramètres

«POST»

/v2.1/anf/pools

Créer un pool de capacité.

Aucune

Attributs de corps de demande requis : `nom, groupe_ressources, emplacement, taille, niveau_service, anf_account_name, subtenant_id'

Exemple corps de la demande :

{
  "name": "string",
  "resource_group": "string",
  "location": "string",
  "size": 10,
  "service_level": "Standard",
  "anf_account_name": "myaccount",
  "subtenant_id": "5d2fb0fb4f47df00015274e3",
  "tags": {
    "key1": "Value 1",
    "key2": "Value 2",
    "key3": "Value 3",
    "keyN": "Value N"
  }
}

Modifiez la taille du pool de capacité

Utilisez la méthode indiquée dans le tableau suivant pour modifier la taille du pool de capacité.

Méthode HTTP Chemin Description Paramètres

`METTRE'

`/v2.1/anf/pools/{name}'

Modifiez la taille du pool de capacité.

name (chaîne de caractères): obligatoire: Le nom unique du pool de capacité.

Attributs de corps de demande requis : `nom, groupe_ressources, emplacement, nom_compte_anf, taille, niveau_service, sous-locataire_id'

Exemple corps de la demande :

{
  "name": "myaccount",
  "resource_group": "string",
  "location": "string",
  "anf_account_name": "myaccount",
  "size": 4,
  "service_level": "Standard",
  "subtenant_id": "5d2fb0fb4f47df00015274e3",
  "tags": {
    "key1": "Value 1",
    "key2": "Value 2",
    "key3": "Value 3",
    "keyN": "Value N"
  }
}

Volumes Azure NetApp Files

Attributs des volumes Azure NetApp Files

Le tableau suivant répertorie les attributs du volume Azure NetApp Files.

Attribut Type Description

`id'

Chaîne

Identifiant unique du volume Azure NetApp Files.

`nom'

Chaîne

Nom du volume Azure NetApp Files.

`groupe_source'

Chaîne

Le groupe de ressources Azure.

`subtenant_id'

Chaîne

ID du sous-locataire.

`anf_account_name'

Chaîne

Nom du compte Azure NetApp Files.

`anf_pool_name'

Chaîne

Nom du pool de Azure NetApp Files.

«emplacement»

Chaîne

Emplacement Azure (région/zone).

chemin_fichier

Chaîne

Création de token ou chemin d’accès au fichier. Chemin de fichier unique pour l’accès au volume.

`quota_size'

Entier

Quota de stockage maximal autorisé en Gio.

ScubNetID

Chaîne

URL de ressource Azure pour un sous-réseau délégué. Doit disposer de la délégation de volumes/NetApp Microsoft.

«balises»

Les paires clé-valeur.

Récupérer les volumes Azure NetApp Files

Utilisez la méthode indiquée dans le tableau suivant pour récupérer les volumes Azure NetApp Files. La spécification d’un `tenant_ID' renvoie uniquement les comptes appartenant à ce tenant.

Méthode HTTP Chemin Description Paramètres de trajectoire

`GET'

/v2.1/anf/volumes

Récupérer les volumes Azure NetApp Files

subtenant_ID: (obligatoire) l’ID du sous-locataire auquel appartient le volume ANF. tenant_ID: (facultatif) renvoie les volumes ANF appartenant au locataire spécifié. Voir aussi "Pagination commune" paramètres.

Paramètres de l’organisme requis: `aucun'.

Récupérez le volume Azure NetApp Files par nom

Utilisez la méthode indiquée dans le tableau ci-dessous pour récupérer un volume Azure NetApp Files par nom.

Méthode HTTP Chemin Description Paramètres

`GET'

`/v2.1/anf/volumes/{name}'

Récupérez un volume Azure NetApp Files par nom.

name (chaîne de caractères): obligatoire: Le nom unique du volume Azure NetApp Files. subtenant_ID: (chaîne de caractères) obligatoire. ID du sous-locataire auquel appartient le volume Azure NetApp Files.

Attributs de corps de demande requis: `aucun'

Exemple corps de la demande :

none

Créer des volumes Azure NetApp Files

Utilisez la méthode indiquée dans le tableau suivant pour créer un volume Azure NetApp Files.

Méthode HTTP Chemin Description Paramètres

«POST»

/v2.1/anf/volumes

Créer un volume Azure NetApp Files.

Aucune

Attributs de corps de demande requis : nom, groupe_ressources, ID_sous-locataire, nom_compte_anf, nom_pool_anf, Virtual_Network, emplacement, chemin_fichier, taille_quota, sous-NetID

Exemple corps de la demande :

{
  "name": "myVolume",
  "resource_group": "string",
  "subtenant_id": "5d2fb0fb4f47df00015274e3",
  "anf_account_name": "myaccount",
  "anf_pool_name": "myaccount",
  "virtual_network": "anf-vnet",
  "location": "string",
  "file_path": "myVolume",
  "quota_size": 100,
  "subNetId": "string",
  "protocol_types": [
    "string"
  ],
  "tags": {
    "key1": "Value 1",
    "key2": "Value 2",
    "key3": "Value 3",
    "keyN": "Value N"
  }
}

Gestion de Cloud Volumes Service pour Google Cloud

L’API /v2.1/gcp/volumes de la catégorie Cloud orchestration permet de gérer les volumes cloud pour votre instance Google Cloud. Avant d’exécuter cette API, assurez-vous que le compte Cloud Volumes Service pour l’abonnement Google Cloud Platform (GCP) a été activé pour le sous-locataire.

Verb. HTTP Chemin Description Paramètres obligatoires/corps de la demande

`GET'

/v2.1/gcp/volumes

Vous pouvez utiliser la méthode OBTENIR pour récupérer les détails de tous les Google Cloud volumes créés pour l’abonnement Cloud Volumes Service de votre sous-locataire.

offset': Nombre d’éléments à ignorer avant de commencer à collecter le jeu de résultats. «Limite»: Le nombre d’articles à retourner. `subtenant_ID: L’ID du sous-locataire abonné à Google Cloud. region: La région du service souscrit.

`GET'

`/v2.1/gcp/volumes/{id}'

Vous pouvez utiliser cette méthode pour récupérer les détails d’un volume Cloud Google Cloud spécifique créé pour l’abonnement Cloud Volumes Service de votre sous-locataire.

ID: L’ID du volume GCP. subtenant_ID: L’ID du sous-locataire abonné à Google Cloud. region: La région du service souscrit.

«POST»

/v2.1/gcp/volumes

Créez un volume GCP pour un sous-locataire. Ajoutez les valeurs dans le corps de la demande pour créer un volume avec les paramètres spécifiés.

` { « subtenant_ID »: «<ID> », « name »: «<Volume_name> », « Region »: «<Region> », « zone »: « < zone> », « creation_token »: «<token> », « Allowed_clients » : «<adresse IP des clients autorisés à accéder à GCP> », « réseau » : « <<détails du réseau tels qu’entrés pour le service souscrit GCP> », « Protocol_types » : [« Protocole pour la connexion, tel que NFSv3> » ], « quota_Gio » : <quota de volume } en octets>, « niveau de service », « étiquette de service », « valeur », « Standard », « valeurs », « Cloud », « différentes », «

EN

`/v2.1/gcp/volumes/{id}'

Modifiez un volume GCP déjà créé pour un sous-locataire. Ajoutez l’ID de volume du volume que vous souhaitez modifier et la valeur des paramètres que vous souhaitez modifier dans le corps de la demande.

` { « subtenant_ID »: «<ID> », « name »: «<Volume_name> », « Region »: «<Region> », « zone »: « < zone> », « allowed_clients »: « Adresse IP des clients autorisés à accéder à GCP> », « quota_bytes », « quantité de services », « quantité », « quantité », « NetApp », « Services », « stockage », « Services », « Services », « quantité », « Services », « quantité », « quantité », « stockage », « Services », « Services », « Services », « NB », « Services », « NB », « NB », « NB », « NB », « stockage », « Services

SUPPRIMER

`/v2.1/gcp/volumes/{id}'

Vous pouvez utiliser cette méthode pour supprimer un volume Google Cloud spécifique créé pour l’abonnement Cloud Volumes Service de votre sous-locataire.

ID: L’ID du volume GCP. subtenant_ID: L’ID du sous-locataire abonné à Cloud Volumes Service pour Google Cloud. region: La région du service souscrit.