Skip to main content
Active IQ Unified Manager
Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Bereitstellen von CIFS- und NFS-Dateifreigaben mithilfe von APIs

Sie können CIFS-Freigaben und NFS-Dateifreigaben auf Ihren Storage Virtual Machines (SVMs) bereitstellen, indem Sie die Bereitstellungs-APIs verwenden, die als Teil von Active IQ Unified Manager bereitgestellt werden. Dieser Bereitstellungs-Workflow beschreibt detailliert die Schritte zum Abrufen der Schlüssel der SVMs, Leistungsservicelevel und Speichereffizienzrichtlinien vor dem Erstellen der Dateifreigaben.

Das folgende Diagramm veranschaulicht jeden Schritt in einem Workflow zur Bereitstellung einer Dateifreigabe. Es umfasst die Bereitstellung sowohl von CIFS-Freigaben als auch von NFS-Dateifreigaben.

Dateifreigaben erstellen
Hinweis

Stellen Sie Folgendes sicher:

  • ONTAP Cluster wurden zu Unified Manager hinzugefügt und der Clusterschlüssel wurde abgerufen.

  • Auf den Clustern wurden SVMs erstellt.

  • Die SVMs unterstützen CIFS- und NFS-Dienste. Die Bereitstellung von Dateifreigaben kann fehlschlagen, wenn die SVMs die erforderlichen Dienste nicht unterstützen.

  • Der FCP-Port ist für die Portbereitstellung online.

  1. Stellen Sie fest, ob Daten-LIFs oder Zugriffsendpunkte auf der SVM verfügbar sind, auf der Sie die CIFS-Freigabe erstellen möchten. Rufen Sie die Liste der verfügbaren Zugriffsendpunkte auf der SVM ab:

    Kategorie HTTP-Verb Weg

    Speicheranbieter

    ERHALTEN

    /storage-provider/access-endpoints /storage-provider/access-endpoints/{key}

    Beispiel-cURL

    curl -X GET "https://<hostname>/api/storage-provider/access-endpoints?resource.key=7d5a59b3-953a-11e8-8857-00a098dcc959" -H "accept: application/json" -H "Authorization: Basic <Base64EncodedCredentials>"
  2. Wenn Ihr Zugriffsendpunkt in der Liste verfügbar ist, rufen Sie den Zugriffsendpunktschlüssel ab, andernfalls erstellen Sie den Zugriffsendpunkt.

    Hinweis

    Stellen Sie sicher, dass Sie Zugriffsendpunkte erstellen, auf denen das CIFS-Protokoll aktiviert ist. Die Bereitstellung von CIFS-Freigaben schlägt fehl, es sei denn, Sie haben einen Zugriffsendpunkt mit aktiviertem CIFS-Protokoll erstellt.

    Kategorie HTTP-Verb Weg

    Speicheranbieter

    POST

    /storage-provider/access-endpoints

    Beispiel-cURL

    Sie müssen die Details des Zugriffsendpunkts, den Sie erstellen möchten, als Eingabeparameter eingeben.

    curl -X POST "https://<hostname>/api/storage-provider/access-endpoints" -H "accept: application/json" -H "Content-Type: application/json" -H "Authorization: Basic <Base64EncodedCredentials>"
    { \"data_protocols\": \"nfs\",
    \"fileshare\": { \"key\": \"cbd1757b-0580-11e8-bd9d-00a098d39e12:type=volume,uuid=f3063d27-2c71-44e5-9a69-a3927c19c8fc\" },
    \"gateway\": \"10.132.72.12\",
    \"ip\": { \"address\": \"10.162.83.26\",
    \"ha_address\": \"10.142.83.26\",
    \"netmask\": \"255.255.0.0\" },
    \"lun\": { \"key\": \"cbd1757b-0580-11e8-bd9d-00a098d39e12:type=lun,uuid=d208cc7d-80a3-4755-93d4-5db2c38f55a6\" },
    \"mtu\": 15000, \"name\": \"aep1\",
    \"svm\": { \"key\": \"cbd1757b-0580-11e8-bd9d-00a178d39e12:type=vserver,uuid=1d1c3198-fc57-11e8-99ca-00a098d38e12\" },
    \"vlan\": 10}"

    Die JSON-Ausgabe zeigt einen Job-Objektschlüssel an, mit dem Sie den von Ihnen erstellten Zugriffsendpunkt überprüfen können.

  3. Überprüfen Sie den Zugriffsendpunkt:

    Kategorie HTTP-Verb Weg

    Management-Server

    ERHALTEN

    /management-server/jobs/{key}

  4. Bestimmen Sie, ob Sie eine CIFS-Freigabe oder eine NFS-Dateifreigabe erstellen müssen. Führen Sie zum Erstellen von CIFS-Freigaben die folgenden Teilschritte aus:

    1. Stellen Sie fest, ob der CIFS-Server auf Ihrer SVM konfiguriert ist, d. h., ob auf der SVM eine Active Directory-Zuordnung erstellt wurde.

      Kategorie HTTP-Verb Weg

      Speicheranbieter

      ERHALTEN

      /storage-provider/active-directories-mappings

    2. Wenn die Active Directory-Zuordnung erstellt ist, nehmen Sie den Schlüssel, andernfalls erstellen Sie die Active Directory-Zuordnung auf der SVM.

      Kategorie HTTP-Verb Weg

      Speicheranbieter

      POST

      /storage-provider/active-directories-mappings

      Beispiel-cURL

      Sie müssen die Details zum Erstellen der Active Directory-Zuordnung als Eingabeparameter eingeben.

    curl -X POST "https://<hostname>/api/storage-provider/active-directories-mappings" -H "accept: application/json" -H "Content-Type: application/json" -H "Authorization: Basic <Base64EncodedCredentials>"
    { \"_links\": {},
    \"dns\": \"10.000.000.000\",
    \"domain\": \"example.com\",
    \"password\": \"string\",
    \"svm\": { \"key\": \"9f4ddea-e395-11e9-b660-005056a71be9:type=vserver,uuid=191a554a-f0ce-11e9-b660-005056a71be9\" },
    \"username\": \"string\"}"

    + Dies ist ein synchroner Aufruf und Sie können die Erstellung der Active Directory-Zuordnung in der Ausgabe überprüfen. Im Falle eines Fehlers wird die Fehlermeldung angezeigt, damit Sie das Problem beheben und die Anfrage erneut ausführen können.

  5. Besorgen Sie sich den SVM-Schlüssel für die SVM, auf der Sie die CIFS-Freigabe oder die NFS-Dateifreigabe erstellen möchten, wie im Workflow-Thema „SVMs auf Clustern überprüfen“ beschrieben.

  6. Rufen Sie den Schlüssel für das Performance-Service-Level ab, indem Sie die folgende API ausführen und den Schlüssel aus der Antwort abrufen.

    Kategorie HTTP-Verb Weg

    Speicheranbieter

    ERHALTEN

    /storage-provider/performance-service-levels

    Hinweis

    Sie können die Details der systemdefinierten Performance Service Levels abrufen, indem Sie die system_defined Eingabeparameter zu true . Rufen Sie aus der Ausgabe den Schlüssel des Performance Service Level ab, den Sie auf die Dateifreigabe anwenden möchten.

  7. Optional können Sie den Schlüssel der Speichereffizienzrichtlinie für die Speichereffizienzrichtlinie abrufen, die Sie auf die Dateifreigabe anwenden möchten, indem Sie die folgende API ausführen und den Schlüssel aus der Antwort abrufen.

    Kategorie HTTP-Verb Weg

    Speicheranbieter

    ERHALTEN

    /storage-provider/storage-efficiency-policies

  8. Erstellen Sie die Dateifreigabe. Sie können eine Dateifreigabe erstellen, die sowohl CIFS als auch NFS unterstützt, indem Sie die Zugriffskontrollliste und die Exportrichtlinie angeben. Die folgenden Unterschritte liefern Informationen, wenn Sie eine Dateifreigabe erstellen möchten, die nur eines der Protokolle auf dem Volume unterstützt. Sie können eine NFS-Dateifreigabe auch aktualisieren, um die Zugriffskontrollliste einzuschließen, nachdem Sie die NFS-Freigabe erstellt haben. Weitere Informationen finden Sie im Thema „Ändern von Speicher-Workloads“.

    1. Um nur eine CIFS-Freigabe zu erstellen, sammeln Sie die Informationen zur Zugriffskontrollliste (ACL). Geben Sie zum Erstellen der CIFS-Freigabe gültige Werte für die folgenden Eingabeparameter an. Für jede Benutzergruppe, die Sie zuweisen, wird eine ACL erstellt, wenn eine CIFS/SMB-Freigabe bereitgestellt wird. Basierend auf den Werten, die Sie für ACL und Active Directory-Zuordnung eingeben, werden die Zugriffskontrolle und die Zuordnung für die CIFS-Freigabe beim Erstellen festgelegt.

      Ein cURL-Befehl mit Beispielwerten

      {
        "access_control": {
          "acl": [
            {
              "permission": "read",
              "user_or_group": "everyone"
            }
          ],
          "active_directory_mapping": {
            "key": "3b648c1b-d965-03b7-20da-61b791a6263c"
          },
    2. Um nur eine NFS-Dateifreigabe zu erstellen, sammeln Sie die Informationen zur Exportrichtlinie. Geben Sie zum Erstellen der NFS-Dateifreigabe gültige Werte für die folgenden Eingabeparameter an. Basierend auf Ihren Werten wird die Exportrichtlinie beim Erstellen mit der NFS-Dateifreigabe verknüpft.

      Hinweis

      Beim Bereitstellen der NFS-Freigabe können Sie entweder eine Exportrichtlinie erstellen, indem Sie alle erforderlichen Werte angeben, oder den Exportrichtlinienschlüssel angeben und eine vorhandene Exportrichtlinie wiederverwenden. Wenn Sie eine Exportrichtlinie für die Speicher-VM wiederverwenden möchten, müssen Sie den Exportrichtlinienschlüssel hinzufügen. Sofern Sie den Schlüssel nicht kennen, können Sie den Exportrichtlinienschlüssel mithilfe des /datacenter/protocols/nfs/export-policies API. Zum Erstellen einer neuen Richtlinie müssen Sie die Regeln wie im folgenden Beispiel angezeigt eingeben. Für die eingegebenen Regeln versucht die API, durch Abgleichen von Host, Speicher-VM und Regeln nach einer vorhandenen Exportrichtlinie zu suchen. Wenn eine Exportrichtlinie vorhanden ist, wird diese verwendet. Andernfalls wird eine neue Exportrichtlinie erstellt.

      Ein cURL-Befehl mit Beispielwerten

      "export_policy": {
            "key": "7d5a59b3-953a-11e8-8857-00a098dcc959:type=export_policy,uuid=1460288880641",
            "name_tag": "ExportPolicyNameTag",
            "rules": [
              {
                "clients": [
                  {
                    "match": "0.0.0.0/0"
                  }

    Geben Sie nach der Konfiguration der Zugriffskontrollliste und der Exportrichtlinie die gültigen Werte für die obligatorischen Eingabeparameter für CIFS- und NFS-Dateifreigaben an:

Hinweis

Die Speichereffizienzrichtlinie ist ein optionaler Parameter zum Erstellen von Dateifreigaben.

Kategorie HTTP-Verb Weg

Speicheranbieter

POST

/storage-provider/file-shares

Die JSON-Ausgabe zeigt einen Job-Objektschlüssel an, mit dem Sie die von Ihnen erstellte Dateifreigabe überprüfen können. . Überprüfen Sie die Erstellung der Dateifreigabe mithilfe des Job-Objektschlüssels, der bei der Abfrage des Jobs zurückgegeben wurde:

Kategorie HTTP-Verb Weg

Management-Server

ERHALTEN

/management-server/jobs/{key}

Am Ende der Antwort sehen Sie den Schlüssel der erstellten Dateifreigabe.

    ],
    "job_results": [
        {
            "name": "fileshareKey",
            "value": "7d5a59b3-953a-11e8-8857-00a098dcc959:type=volume,uuid=e581c23a-1037-11ea-ac5a-00a098dcc6b6"
        }
    ],
    "_links": {
        "self": {
            "href": "/api/management-server/jobs/06a6148bf9e862df:-2611856e:16e8d47e722:-7f87"
        }
    }
}
  1. Überprüfen Sie die Erstellung der Dateifreigabe, indem Sie die folgende API mit dem zurückgegebenen Schlüssel ausführen:

    Kategorie HTTP-Verb Weg

    Speicheranbieter

    ERHALTEN

    /storage-provider/file-shares/{key}

    Beispiel für JSON-Ausgabe

    Sie können sehen, dass die POST-Methode von /storage-provider/file-shares ruft intern alle für die einzelnen Funktionen erforderlichen APIs auf und erstellt das Objekt. Beispielsweise ruft es die /storage-provider/performance-service-levels/ API zum Zuweisen des Performance-Servicelevels auf der Dateifreigabe.

    {
        "key": "7d5a59b3-953a-11e8-8857-00a098dcc959:type=volume,uuid=e581c23a-1037-11ea-ac5a-00a098dcc6b6",
        "name": "FileShare_377",
        "cluster": {
            "uuid": "7d5a59b3-953a-11e8-8857-00a098dcc959",
            "key": "7d5a59b3-953a-11e8-8857-00a098dcc959:type=cluster,uuid=7d5a59b3-953a-11e8-8857-00a098dcc959",
            "name": "AFFA300-206-68-70-72-74",
            "_links": {
                "self": {
                    "href": "/api/datacenter/cluster/clusters/7d5a59b3-953a-11e8-8857-00a098dcc959:type=cluster,uuid=7d5a59b3-953a-11e8-8857-00a098dcc959"
                }
            }
        },
        "svm": {
            "uuid": "b106d7b1-51e9-11e9-8857-00a098dcc959",
            "key": "7d5a59b3-953a-11e8-8857-00a098dcc959:type=vserver,uuid=b106d7b1-51e9-11e9-8857-00a098dcc959",
            "name": "RRT_ritu_vs1",
            "_links": {
                "self": {
                    "href": "/api/datacenter/svm/svms/7d5a59b3-953a-11e8-8857-00a098dcc959:type=vserver,uuid=b106d7b1-51e9-11e9-8857-00a098dcc959"
                }
            }
        },
        "assigned_performance_service_level": {
            "key": "1251e51b-069f-11ea-980d-fa163e82bbf2",
            "name": "Value",
            "peak_iops": 75,
            "expected_iops": 75,
            "_links": {
                "self": {
                    "href": "/api/storage-provider/performance-service-levels/1251e51b-069f-11ea-980d-fa163e82bbf2"
                }
            }
        },
        "recommended_performance_service_level": {
            "key": null,
            "name": "Idle",
            "peak_iops": null,
            "expected_iops": null,
            "_links": {}
        },
        "space": {
            "size": 104857600
        },
        "assigned_storage_efficiency_policy": {
            "key": null,
            "name": "Unassigned",
            "_links": {}
        },
        "access_control": {
            "acl": [
                {
                    "user_or_group": "everyone",
                    "permission": "read"
                }
            ],
            "export_policy": {
                "id": 1460288880641,
                "key": "7d5a59b3-953a-11e8-8857-00a098dcc959:type=export_policy,uuid=1460288880641",
                "name": "default",
                "rules": [
                    {
                        "anonymous_user": "65534",
                        "clients": [
                            {
                                "match": "0.0.0.0/0"
                            }
                        ],
                        "index": 1,
                        "protocols": [
                            "nfs3",
                            "nfs4"
                        ],
                        "ro_rule": [
                            "sys"
                        ],
                        "rw_rule": [
                            "sys"
                        ],
                        "superuser": [
                            "none"
                        ]
                    },
                    {
                        "anonymous_user": "65534",
                        "clients": [
                            {
                                "match": "0.0.0.0/0"
                            }
                        ],
                        "index": 2,
                        "protocols": [
                            "cifs"
                        ],
                        "ro_rule": [
                            "ntlm"
                        ],
                        "rw_rule": [
                            "ntlm"
                        ],
                        "superuser": [
                            "none"
                        ]
                    }
                ],
                "_links": {
                    "self": {
                        "href": "/api/datacenter/protocols/nfs/export-policies/7d5a59b3-953a-11e8-8857-00a098dcc959:type=export_policy,uuid=1460288880641"
                    }
                }
            }
        },
        "_links": {
            "self": {
                "href": "/api/storage-provider/file-shares/7d5a59b3-953a-11e8-8857-00a098dcc959:type=volume,uuid=e581c23a-1037-11ea-ac5a-00a098dcc6b6"
            }
        }
    }