Skip to main content
Active IQ Unified Manager
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Provisionnez les partages de fichiers CIFS et NFS à l'aide d'API

PDF

Vous pouvez provisionner des partages CIFS et des partages de fichiers NFS sur vos machines virtuelles de stockage (SVM) à l'aide des API de provisionnement fournies dans le cadre d' Active IQ Unified Manager. Ce flux de travail de provisionnement détaille les étapes de récupération des clés des SVM, des niveaux de service de performances et des politiques d'efficacité de stockage avant de créer les partages de fichiers.

Le diagramme suivant illustre chaque étape d’un flux de travail de provisionnement de partage de fichiers. Il inclut le provisionnement des partages CIFS et des partages de fichiers NFS.

créer des partages de fichiers
Remarque

Assurez-vous de ce qui suit :

  • Les clusters ONTAP ont été ajoutés à Unified Manager et la clé de cluster a été obtenue.

  • Des SVM ont été créés sur les clusters.

  • Les SVM prennent en charge les services CIFS et NFS. Le provisionnement des partages de fichiers peut échouer si les SVM ne prennent pas en charge les services requis.

  • Le port FCP est en ligne pour le provisionnement des ports.

  1. Déterminez si les LIF de données ou les points de terminaison d’accès sont disponibles sur la SVM sur laquelle vous souhaitez créer le partage CIFS. Obtenez la liste des points de terminaison d’accès disponibles sur la SVM :

    Catégorie verbe HTTP Chemin

    fournisseur de stockage

    OBTENIR

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

    Exemple de 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. Si votre point de terminaison d'accès est disponible dans la liste, obtenez la clé du point de terminaison d'accès, sinon créez le point de terminaison d'accès.

    Remarque

    Assurez-vous de créer des points de terminaison d’accès sur lesquels le protocole CIFS est activé. Le provisionnement des partages CIFS échoue sauf si vous avez créé un point de terminaison d'accès avec le protocole CIFS activé.
    Catégorie verbe HTTP Chemin

    fournisseur de stockage

    POSTE

    /storage-provider/access-endpoints

    Exemple de cURL

    Vous devez saisir les détails du point de terminaison d’accès que vous souhaitez créer, en tant que paramètres d’entrée.

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

    La sortie JSON affiche une clé d’objet Job que vous pouvez utiliser pour vérifier le point de terminaison d’accès que vous avez créé.

  3. Vérifiez le point de terminaison d'accès :

    Catégorie verbe HTTP Chemin

    serveur de gestion

    OBTENIR

    /management-server/jobs/{key}

  4. Déterminez si vous devez créer un partage CIFS ou un partage de fichiers NFS. Pour créer des partages CIFS, suivez ces sous-étapes :

    1. Déterminez si le serveur CIFS est configuré sur votre SVM, c'est-à-dire si un mappage Active Directory est créé sur le SVM.

      Catégorie verbe HTTP Chemin

      fournisseur de stockage

      OBTENIR

      /storage-provider/active-directories-mappings

    2. Si le mappage Active Directory est créé, prenez la clé, sinon créez le mappage Active Directory sur le SVM.

      Catégorie verbe HTTP Chemin

      fournisseur de stockage

      POSTE

      /storage-provider/active-directories-mappings

      Exemple de cURL

      Vous devez saisir les détails pour la création du mappage Active Directory, en tant que paramètres d'entrée.

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

    + Il s’agit d’un appel synchrone et vous pouvez vérifier la création du mappage Active Directory dans la sortie. En cas d'erreur, le message d'erreur s'affiche pour vous permettre de résoudre le problème et de réexécuter la demande.

  5. Obtenez la clé SVM pour la SVM sur laquelle vous souhaitez créer le partage CIFS ou le partage de fichiers NFS, comme décrit dans la rubrique de workflow Vérification des SVM sur les clusters.

  6. Obtenez la clé du niveau de service de performance en exécutant l’API suivante et en récupérant la clé à partir de la réponse.

    Catégorie verbe HTTP Chemin

    fournisseur de stockage

    OBTENIR

    /storage-provider/performance-service-levels
    Remarque

    Vous pouvez récupérer les détails des niveaux de service de performance définis par le système en définissant le system_defined paramètre d'entrée à true . À partir de la sortie, obtenez la clé du niveau de service de performances que vous souhaitez appliquer sur le partage de fichiers.

  7. Vous pouvez également obtenir la clé de stratégie d’efficacité de stockage pour la stratégie d’efficacité de stockage que vous souhaitez appliquer sur le partage de fichiers en exécutant l’API suivante et en récupérant la clé à partir de la réponse.

    Catégorie verbe HTTP Chemin

    fournisseur de stockage

    OBTENIR

    /storage-provider/storage-efficiency-policies

  8. Créez le partage de fichiers. Vous pouvez créer un partage de fichiers prenant en charge CIFS et NFS en spécifiant la liste de contrôle d'accès et la politique d'exportation. Les sous-étapes suivantes fournissent des informations si vous souhaitez créer un partage de fichiers pour prendre en charge un seul des protocoles sur le volume. Vous pouvez également mettre à jour un partage de fichiers NFS pour inclure la liste de contrôle d'accès après avoir créé le partage NFS. Pour plus d'informations, consultez la rubrique Modification des charges de travail de stockage.

    1. Pour créer uniquement un partage CIFS, collectez les informations sur la liste de contrôle d'accès (ACL). Pour créer le partage CIFS, fournissez des valeurs valides pour les paramètres d’entrée suivants. Pour chaque groupe d’utilisateurs que vous attribuez, une ACL est créée lorsqu’un partage CIFS/SMB est provisionné. En fonction des valeurs que vous entrez pour le mappage ACL et Active Directory, le contrôle d’accès et le mappage sont déterminés pour le partage CIFS lors de sa création.

      Une commande cURL avec des exemples de valeurs

      {
  "access_control": {
    "acl": [
      {
        "permission": "read",
        "user_or_group": "everyone"
      }
    ],
    "active_directory_mapping": {
      "key": "3b648c1b-d965-03b7-20da-61b791a6263c"
    },

    2. Pour créer uniquement un partage de fichiers NFS, collectez les informations sur la politique d'exportation. Pour créer le partage de fichiers NFS, fournissez des valeurs valides pour les paramètres d’entrée suivants. En fonction de vos valeurs, la politique d’exportation est associée au partage de fichiers NFS lors de sa création.

      Remarque

      Lors de l'approvisionnement du partage NFS, vous pouvez soit créer une politique d'exportation en fournissant toutes les valeurs requises, soit fournir la clé de politique d'exportation et réutiliser une politique d'exportation existante. Si vous souhaitez réutiliser une politique d’exportation pour la machine virtuelle de stockage, vous devez ajouter la clé de politique d’exportation. À moins que vous ne connaissiez la clé, vous pouvez récupérer la clé de la politique d'exportation en utilisant le /datacenter/protocols/nfs/export-policies API. Pour créer une nouvelle politique, vous devez saisir les règles telles qu'elles sont affichées dans l'exemple suivant. Pour les règles saisies, l'API tente de rechercher une politique d'exportation existante en faisant correspondre l'hôte, la machine virtuelle de stockage et les règles. S’il existe une politique d’exportation, elle est utilisée. Sinon, une nouvelle politique d’exportation est créée.

      Une commande cURL avec des exemples de valeurs

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

    Après avoir configuré la liste de contrôle d'accès et la politique d'exportation, fournissez les valeurs valides pour les paramètres d'entrée obligatoires pour les partages de fichiers CIFS et NFS :

Remarque

La politique d’efficacité du stockage est un paramètre facultatif pour la création de partages de fichiers.
Catégorie verbe HTTP Chemin

fournisseur de stockage

POSTE

/storage-provider/file-shares

La sortie JSON affiche une clé d’objet Job que vous pouvez utiliser pour vérifier le partage de fichiers que vous avez créé. . Vérifiez la création du partage de fichiers à l'aide de la clé d'objet Job renvoyée lors de l'interrogation du travail :

Catégorie verbe HTTP Chemin

serveur de gestion

OBTENIR

/management-server/jobs/{key}

À la fin de la réponse, vous voyez la clé du partage de fichiers créé.

    ],
    "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. Vérifiez la création du partage de fichiers en exécutant l'API suivante avec la clé renvoyée :

    Catégorie verbe HTTP Chemin

    fournisseur de stockage

    OBTENIR

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

    Exemple de sortie JSON

    Vous pouvez voir que la méthode POST de /storage-provider/file-shares appelle en interne toutes les API requises pour chacune des fonctions et crée l'objet. Par exemple, il invoque le /storage-provider/performance-service-levels/ API pour attribuer le niveau de service de performance sur le partage de fichiers.

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