Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

APIs zur Cloud-Orchestrierung

Beitragende

Die Cloud-Orchestrierungs-APIs NetApp Service Engine unterstützt das Verbinden von Cloud Volumes Services mit der NetApp Service Engine und das Arbeiten mit ihnen über die NetApp Service Engine. Azure NetApp Files (ANF) und Google Cloud Platform (GCP) werden für Cloud Volumes Services unterstützt.

Abonnements von Cloud Volumes Services werden außerhalb der NetApp Service Engine gemanagt. Die entsprechenden Zugangsdaten werden an die NetApp Service Engine zur Verfügung gestellt, um die Verbindung zu den Cloud-Services zu ermöglichen.

In diesem Abschnitt werden die APIs für beschrieben:

  • Verwalten von Cloud Volumes Service Instanzen

  • Verwalten von Azure NetApp Files-Konten

  • Verwalten von Azure NetApp Files Capacity Pools

  • Verwalten von Azure NetApp Files Volumes

  • Managen Von Google Cloud Volumes

Cloud Volumes Service Instanzen

Verwenden Sie die in der folgenden Tabelle aufgeführten Methoden, um Cloud Volumes Service-Instanzen abzurufen und zu erstellen.

HTTP-Methode Pfad Beschreibung

GET

/v2.1/cvs/instances

Rufen Sie alle Cloud Volumes Service-Instanzen ab.

POST

/v2.1/cvs/instances

Erstellen neuer Cloud Volumes Service Instanzen

GET

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

Rufen Sie eine Cloud Volumes Service-Instanz anhand der ID ab.

GET

/v2.1/anf/Accounts

Rufen Sie Azure NetApp Files-Konten ab.

POST

/v2.1/anf/Accounts

Erstellen Sie ein Azure NetApp Files-Konto

GET

/v2.1/anf/Accounts/{id}

Rufen Sie ein Azure NetApp Files-Konto anhand der ID ab.

GET

/v2.1/anf/Pools

Abrufen aller Kapazitäts-Pools

POST

/v2.1/anf/Pools`

Erstellen Sie einen Kapazitäts-Pool.

GET

/v2.1/anf/Pools/{id}

Abrufen eines Azure NetApp Files-Kapazitäts-Pools nach ID

Attribute der Cloud Volumes Service Instanz

In der folgenden Tabelle werden die Attribute der Cloud Volumes Service Instanz aufgeführt.

Attribut Typ Beschreibung

id

Zeichenfolge

Eindeutige Kennung für die Cloud Volumes Service-Instanz.

Name

Zeichenfolge

Name der Cloud Volumes Service-Instanz.

cc_Working_env

Zeichenfolge

Name der Arbeitsumgebung in BlueXP.

cc_Client_id

Zeichenfolge

Auth0-Dienst-ID.

cc_refresh_Token

Zeichenfolge

Authenti0-Token aktualisieren.

cc_Account_id

Zeichenfolge

Cloud Central: Konto-ID

cc_Account_Name

Zeichenfolge

Kontoname für Cloud Central

cc_redentials_id

Zeichenfolge

ID der Arbeitsumgebung Cloud Centra

Azure_Client_id

Zeichenfolge

Applikations-(Client-)ID. Die ID eines Active Directory-Dienstprinzipals, den BlueXP zur Authentifizierung mit Azure Active Directory verwenden kann.

Azure_Client_Secret

Zeichenfolge

Der Wert des Client Secret für die Service-Hauptanwendung.

Azure_Tenant_id

Zeichenfolge

Die Azure Active Directory-ID. Dies wird auch als Mandanten-ID bezeichnet.

Azure_subscription_id

Zeichenfolge

Die Azure Active Directory Abonnement-ID.

subTenant_id

Zeichenfolge

Die Untermandant-ID.

Tags

Die Schlüssel-Wert-Paare.

Rufen Sie die Cloud Volumes Service Instanz ab

HTTP-Methode Pfad Beschreibung Pfadparameter

GET

/v2.1/cvs/instances

Rufen Sie Cloud Volumes Service Instanzen ab.

Tenant_id: (optional) gibt die Cloud Volumes Service-Instanzen zurück, die zum angegebenen Mandanten gehören. Siehe auch "Gemeinsame Paginierung" Parameter.

Erforderliche Body-Parameter für Anforderung: none

Rufen Sie die Cloud Volumes Service-Instanz anhand der ID ab

Verwenden Sie die in der folgenden Tabelle aufgeführte Methode, um eine Cloud Volumes Service-Instanz anhand ihrer Kennung abzurufen.

HTTP-Methode Pfad Beschreibung Parameter

GET

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

Rufen Sie eine Cloud Volumes Service-Instanz anhand der ID ab.

id (String): die eindeutige Kennung der Cloud Volumes Service-Instanz.

Erforderliche Body-Attribute für Anforderung: none

Erstellen von Cloud Volumes Service-Instanzen

Verwenden Sie die in der folgenden Tabelle aufgeführte Methode zum Erstellen einer neuen Cloud Volumes Service-Instanz.

HTTP-Methode Pfad Beschreibung Parameter

POST

/v2.1/cvs/instances

Erstellen Sie eine Cloud Volumes Service Instanz.

Keine

Erforderliche Body-Attribute der Anforderung: 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, Untermandant_id

Beispiel des Körpers anfordern:

{
  "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"
  }
}

Verwalten von Tags für Cloud Volumes Service Instanzen

Verwenden Sie die in der folgenden Tabelle aufgeführte Methode, um Tags für die benannte Cloud Volumes Service Instanz anzugeben.

HTTP-Methode Pfad Beschreibung Parameter

POST

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

Tags für eine Cloud Volumes Service Instanz verwalten.

id (String)`: Die eindeutige Kennung der Cloud Volumes Service-Instanz.

Erforderliche Body-Attribute für Anforderung: Key-Value-Paare

Beispiel des Körpers anfordern:

{
  "env": "test"
}

Azure NetApp Files Accounts

Attribute von Azure NetApp Files-Accounts

In der folgenden Tabelle werden die Attribute des Azure NetApp Files-Kontos aufgeführt.

Attribut Typ Beschreibung

id

Zeichenfolge

Die eindeutige Kennung für das Azure NetApp Files-Konto.

Name

Zeichenfolge

Der Name des Azure NetApp Files-Kontos.

resource_Group

Zeichenfolge

Die Azure-Ressourcengruppe.

location

Zeichenfolge

Der Azure-Standort (Region/Zone).

cvs_Instance_id

Zeichenfolge

Die Cloud Volumes Service Instanz-ID.

Tags

Die Schlüssel-Wert-Paare.

Rufen Sie Azure NetApp Files-Konten ab

HTTP-Methode Pfad Beschreibung Pfadparameter

GET

/v2.1/anf/Accounts

Rufen Sie Azure NetApp Files-Konten ab.

subtenant_id: (obligatorisch) die Untermandant-ID, zu der das Azure NetApp Files-Konto gehört. Tenant_id: (optional) gibt die Azure NetApp Files-Konten zurück, die zum angegebenen Mandanten gehören. Siehe auch "Gemeinsame Paginierung" Parameter.

Erforderliche Body-Parameter für Anforderung: none

Rufen Sie das Azure NetApp Files-Konto anhand des Namens ab

Verwenden Sie die in der folgenden Tabelle aufgeführte Methode, um ein Azure NetApp Files-Konto nach Namen abzurufen.

HTTP-Methode Pfad Beschreibung Parameter

GET

/v2.1/anf/Accounts/{Name}

Rufen Sie ein Azure NetApp Files-Konto nach Namen ab.

Name (String): (obligatorisch) der Name des Azure NetApp Files-Kontos. subtenant_id (String): (obligatorisch) die Untermandant-ID, zu der das Azure NetApp Files-Konto gehört.

Erforderliche Body-Attribute für Anforderung: none

Erstellen von Azure NetApp Files Accounts

Verwenden Sie die in der folgenden Tabelle aufgeführte Methode zum Erstellen eines neuen Azure NetApp Files-Kontos.

HTTP-Methode Pfad Beschreibung Parameter

POST

/v2.1/anf/Accounts

Erstellen Sie ein neues Azure NetApp Files Konto.

Keine

Erforderliche Body-Attribute für Anforderung: Name, Resource_Group, location, cvs_Instance_id

Beispiel des Körpers anfordern:

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

Azure NetApp Files Kapazitäts-Pools

Attribute für Kapazitäts-Pools

In der folgenden Tabelle werden die Attribute des Kapazitäts-Pools aufgeführt.

Attribut Typ Beschreibung

id

Zeichenfolge

Die eindeutige Kennung für den Kapazitäts-Pool.

Name

Zeichenfolge

Der Name des Kapazitäts-Pools.

resource_Group

Zeichenfolge

Die Azure-Ressourcengruppe.

location

Zeichenfolge

Der Azure-Standort (Region/Zone).

size

Ganzzahl

Die Größe des Kapazitäts-Pools in TB.

sService_Level

Zeichenfolge

Der Name des Servicelevels: Ultra, Premium oder Standard.

anf_Account_Name

Zeichenfolge

Die ID der Azure NetApp Files-Kontoinstanz.

subTenant_id

Zeichenfolge

Die Untermandant-ID.

Tags

Die Schlüssel-Wert-Paare.

Abrufen von Kapazitäts-Pools

HTTP-Methode Pfad Beschreibung Pfadparameter

GET

/v2.1/anf/Pools

Abrufen von Kapazitäts-Pools

subtenant_id: (obligatorisch) die Untermandant-ID, zu der das ANF-Konto gehört. Tenant_id: (optional) gibt die Kapazitätspools zurück, die zum angegebenen Mandanten gehören. Siehe auch "Gemeinsame Paginierung" Parameter.

Erforderliche Body-Parameter für Anforderung: none

Beispiel des Körpers anfordern:

none

Abrufen des Kapazitäts-Pools nach Namen

Verwenden Sie die in der folgenden Tabelle aufgeführte Methode, um einen Kapazitätspool nach Namen abzurufen.

HTTP-Methode Pfad Beschreibung Parameter

GET

/v2.1/anf/Pools/{Name}

Abrufen eines Kapazitäts-Pools nach Namen

Name (String): (obligatorisch) der eindeutige Name des Kapazitäts-Pools. subTenant_id (String): (obligatorisch) die Untermandant-ID, zu der der Kapazitätspool gehört.

Erforderliche Body-Attribute für Anforderung: none

Erstellung von Kapazitätspools

Verwenden Sie die in der folgenden Tabelle aufgeführte Methode zum Erstellen eines neuen Kapazitäts-Pools.

HTTP-Methode Pfad Beschreibung Parameter

POST

/v2.1/anf/Pools

Erstellen Sie einen Kapazitäts-Pool.

Keine

Erforderliche Body-Attribute für Anforderung: Name, Resource_Group, Standort, Größe, Service_Level, anf_Account_Name, Submandant_id

Beispiel des Körpers anfordern:

{
  "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"
  }
}

Ändern Sie die Größe des Kapazitäts-Pools

Verwenden Sie die in der folgenden Tabelle aufgeführte Methode, um die Größe des Kapazitäts-Pools zu ändern.

HTTP-Methode Pfad Beschreibung Parameter

PUT

/v2.1/anf/Pools/{Name}

Ändern Sie die Größe des Kapazitäts-Pools.

Name (String): Pflichtfeld: Der eindeutige Name des Kapazitäts-Pools.

Erforderliche Body-Attribute für Anforderung: Name, Resource_Group, location, anf_Account_Name, size, Service_Level, Submandant_id

Beispiel des Körpers anfordern:

{
  "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"
  }
}

Azure NetApp Files Volumes

Azure NetApp Files Volume-Attribute

In der folgenden Tabelle werden die Attribute des Azure NetApp Files Volume aufgeführt.

Attribut Typ Beschreibung

id

Zeichenfolge

Die eindeutige Kennung für das Azure NetApp Files-Volume.

Name

Zeichenfolge

Der Name des Azure NetApp Files Volume.

resource_Group

Zeichenfolge

Die Azure-Ressourcengruppe.

subTenant_id

Zeichenfolge

Die Untermandant-ID.

anf_Account_Name

Zeichenfolge

Der Azure NetApp Files-Kontoname

anf_Pool_Name

Zeichenfolge

Der Name des Azure NetApp Files Pools.

location

Zeichenfolge

Der Azure-Standort (Region/Zone).

file_path

Zeichenfolge

Erstellen von Token oder Dateipfad Ein eindeutiger Dateipfad für den Zugriff auf das Volume.

quota_size

Ganzzahl

Maximale Anzahl an Storage-Kontingenten in gib zulässig.

subNetID

Zeichenfolge

Die Azure-Ressourcen-URL für ein delegiertes Subnetz. Die Delegation von Microsoft NetApp/Volumes muss vorhanden sein.

Tags

Die Schlüssel-Wert-Paare.

Rufen Sie Azure NetApp Files Volumes ab

Verwenden Sie die in der folgenden Tabelle aufgeführte Methode zum Abrufen von Azure NetApp Files-Volumes. Wenn Sie eine Tenant_id angeben, werden nur die Konten zurückgegeben, die zu diesem Mandanten gehören.

HTTP-Methode Pfad Beschreibung Pfadparameter

GET

/v2.1/anf/Volumes

Rufen Sie Azure NetApp Files Volumes ab.

subTenant_id: (obligatorisch) die Untermandant-ID, zu der das ANF-Volume gehört. Tenant_id: (optional) gibt die ANF-Volumes zurück, die zum angegebenen Mandanten gehören. Siehe auch "Gemeinsame Paginierung" Parameter.

Erforderliche Body-Parameter für Anforderung: none.

Rufen Sie das Azure NetApp Files-Volumen nach Namen ab

Verwenden Sie die in der folgenden Tabelle aufgeführte Methode, um ein Azure NetApp Files-Volume nach Namen abzurufen.

HTTP-Methode Pfad Beschreibung Parameter

GET

/v2.1/anf/Volumes/{Name}

Rufen Sie ein Azure NetApp Files-Volume nach Namen ab.

Name (Zeichenfolge): Pflichtfeld: Der eindeutige Name des Azure NetApp Files-Volumes. subTenant_id: (String) obligatorisch. Die Untermandant-ID, zu der das Azure NetApp Files-Volume gehört.

Erforderliche Body-Attribute für Anforderung: none

Beispiel des Körpers anfordern:

none

Azure NetApp Files Volumes erstellen

Verwenden Sie die in der folgenden Tabelle aufgeführte Methode zur Erstellung eines neuen Azure NetApp Files Volumes.

HTTP-Methode Pfad Beschreibung Parameter

POST

/v2.1/anf/Volumes

Azure NetApp Files Volume erstellen

Keine

Erforderliche Body-Attribute für Anforderung: Name, Resource_Group, subtenant_id, anf_Account_Name, anf_Pool_Name, Virtual_Network, location, file_path, quota_size, subNetID

Beispiel des Körpers anfordern:

{
  "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"
  }
}

Managing Cloud Volumes Service for Google Cloud

Mit der`/v2.1/gcp/Volumes ` API unter der Kategorie Cloud-Orchestrierung können Sie Cloud-Volumes für Ihre Google-Cloud-Instanz managen. Stellen Sie vor der Ausführung dieser API sicher, dass das Cloud Volumes Service-Konto für die Google Cloud Platform (GCP)-Abonnement für den Untermandanten aktiviert wurde.

HTTP-Verb Pfad Beschreibung Obligatorische Parameter/Anforderungskörper

GET

/v2.1/gcp/Volumes

Sie können die GET-Methode verwenden, um die Details aller Google Cloud Volumes abzurufen, die für das Cloud Volumes Service-Abonnement Ihres Submandanten erstellt wurden.

Offset: Die Anzahl der zu übersprinenden Elemente, bevor der Ergebnissatz erfasst wird. Limit: Die Anzahl der zurückzukehrenden Artikel. subTenant_id: Die ID des Submieters, der bei Google Cloud abonniert wurde. reRegion: Die Region des gezeichneten Dienstes.

GET

/v2.1/gcp/Volumes/{id}

Mit dieser Methode können Sie die Details eines bestimmten Google Cloud Volumes abrufen, das für das Cloud Volumes Service-Abonnement Ihres Submandanten erstellt wurde.

id: Die ID des GCP-Volumes. subTenant_id: Die ID des Submieters, der bei Google Cloud abonniert wurde. reRegion: Die Region des gezeichneten Dienstes.

POST

/v2.1/gcp/Volumes

Erstellen eines GCP-Volumes für einen Untermandanten. Fügen Sie die Werte im Anfraentext hinzu, um ein Volumen mit den angegebenen Parametern zu erstellen.

` { „Subtenant_id“: „<ID>“, „Name“: „<Volume_Name>“, „Region“: „<Region>“, „Zone“: „<Zone>“, „create_Token“: „<Token>“, „allowed_Clients“: „<IP-Adresse der Clients Zugriff auf GCP>“, „Netzwerk“: „<Netzwerkdetails, wie sie für den GCP-Dienst eingegeben wurden>“, „Protocol_Types“: [ „<Protokoll für die Verbindung, wie NFSv3>“ ], „quota_gib“: <Volume quota in Bytes>, „Service_Level“: „<der Typ des Performance Service Level, wie Standard>“, „Wert<“, } `

PUT

/v2.1/gcp/Volumes/{id}

Änderung eines GCP Volume, das bereits für einen Submandanten erstellt wurde Fügen Sie die Volume-ID des zu ändernden Volumens sowie den Wert für die Parameter, die Sie ändern möchten, im Anforderungentext hinzu.

` { „Subtenant_id“: „<ID>“, „Name“: „<Volume_Name>“, „Region“: „<Region>“, „Zone“: „<Zone>“, „allowed_Clients“: „<IP-Adresse der Clients, auf GCP>“, „quota_gib“: <Volume quota in Bytes>, „Service_Level“: „<der Typ der Leistungstypen des NFSv3“, z. B. „<Standard-Kennzeichens> „ } `“, z. B. „<“

Löschen

/v2.1/gcp/Volumes/{id}

Mit dieser Methode können Sie ein bestimmtes Google Cloud Volume löschen, das für das Cloud Volumes Service-Abonnement Ihres Submandanten erstellt wurde.

id: Die ID des GCP-Volumes. subTenant_id: Die ID des Submandanten, der bei Cloud Volumes Service für Google Cloud angemeldet ist. reRegion: Die Region des gezeichneten Dienstes.