Modification des fonctionnalités d'image pour les images personnalisées

Exemples d'interface de ligne de commande

Pour répertorier les schémas globaux de fonctionnalités d'image :

oci compute global-image-capability-schema list

Pour répertorier les versions de schéma global de fonctionnalités d'image :

oci compute global-image-capability-schema-version list --global-image-capability-schema-id <global_image_capability_schema_OCID>
                        

Pour extraire la version de schéma global de fonctionnalités d'image :

oci compute global-image-capability-schema-version get --global-image-capability-schema-id <global_image_capability_schema_OCID> --global-image-capability-schema-version-name <version_name>
                        

Pour répertorier les schémas de fonctionnalités d'image du compartiment spécifié :

oci compute image-capability-schema list --compartment-id <compartment_OCID>
                        

Pour extraire le schéma de fonctionnalités d'image correspondant à l'ID spécifié :

oci compute image-capability-schema get --image-capability-schema-id <image_capability_schema_OCID>
                        

Pour mettre à jour le schéma de fonctionnalités d'image indiqué :

oci -d compute image-capability-schema update --image-capability-schema-id <image_capability_schema_OCID> --schema-data file://<schema_data_file>.json

Pour créer un schéma de fonctionnalités d'image :

oci compute image-capability-schema create --schema-data file://<schema_data_file>.json --compartment-id <compartment_OCID> --image-id <image_OCID> --global-image-capability-schema-version-name <version_name>
                        

Lorsque vous créez le schéma, vous indiquez l'OCID de l'image personnalisée à laquelle vous voulez appliquer le schéma de fonctionnalités d'image.

Pour supprimer le schéma de fonctionnalités d'image indiqué :

oci -d compute image-capability-schema delete --image-capability-schema-id <image_capability_schema_OCID>
                        

Exemple d'utilisation

Cet exemple montre comment utiliser la CLI pour mettre à jour le schéma de fonctionnalités de l'image pour une image personnalisée. Pour obtenir des informations sur l'utilisation de l'interface de ligne de commande, reportez-vous à Interface de ligne de commande (CLI).

1. Ouvrez une invite de commande et exécutez la commande suivante pour extraire le schéma global en cours de la région :

   oci compute global-image-capability-schema list

   La réponse se présente de la manière suivante :

   {
       "data": [
           {
               "compartment-id": null,
               "current-version-name": "<varname>&lt;version_name></varname>",
               "defined-tags": {},
               "display-name": "OCI.ComputeGlobalImageCapabilitySchema",
               "freeform-tags": {},
               "id": "ocid1.computeglobalimgcapschema.oc1.phx.<varname>&lt;unique_ID></varname>",
               "time-created": "2020-03-23T19:20:39.656000+00:00"
           }
       ],
       "opc-next-page": "<varname>&lt;unique_ID></varname>"
   }

2. En utilisant l'OCID et le nom de version de schéma global des fonctionnalités d'image extrait à l'étape précédente, exécutez la commande suivante pour obtenir le schéma global des fonctionnalités d'image :

   oci compute global-image-capability-schema-version get --global-image-capability-schema-id <global_image_capability_schema_OCID> --global-image-capability-schema-version-name <version_name>
                                   

   La réponse contient le schéma global de fonctionnalités d'image.

3. Recherchez l'élément de schéma à mettre à jour, puis procédez comme suit :

   1. Copiez l'élément de schéma à mettre à jour. Cet exemple utilise l'élément de schéma Storage.ParaVirtualization.EncryptionInTransit.

   2. Si l'élément de schéma contient un champ source, remplacez la valeur GLOBAL par IMAGE. Par exemple :

      {
          "Storage.ParaVirtualization.EncryptionInTransit": {
              "default-value": true,
              "descriptor-type": "boolean",
              "source": "IMAGE"
          }
      }

   3. Enregistrez les éléments de schéma mis à jour dans un fichier .json.

4. Pour vérifier si l'image utilise déjà une fonctionnalité d'image, exécutez la commande suivante :

   oci compute image-capability-schema list --image-id <image_OCID>
                                   

   • Si l'image utilise la fonctionnalité d'image, la réponse contient une ligne semblable à la suivante :

     "compute-global-image-capability-schema-version-name": "<version_name>"

     La réponse contient également l'OCID de schéma de fonctionnalité d'image.

   • Si l'image n'utilise pas de fonctionnalité d'image, créez un schéma de fonctionnalité d'image pour l'image en exécutant la commande suivante :

     oci compute image-capability-schema create --global-image-capability-schema-version-name <version_name> --image-id <image_OCID> --schema-data file://<schema_data_file>.json --compartment-id <compartment_OCID>
                                             

     <schema_data_file> est le chemin du fichier .json qui contient les éléments de schéma à mettre à jour, que vous avez créés à l'étape précédente.

     La réponse se présente de la manière suivante :

     {
         "data": {
             "compartment-id": "ocid1.compartment.oc1..<varname>&lt;unique_ID></varname>",
             "compute-global-image-capability-schema-id": "ocid1.computeglobalimgcapschema.oc1.phx.<varname>&lt;unique_ID></varname>",
             "compute-global-image-capability-schema-version-name": "<varname>&lt;version_name></varname>",
             "defined-tags": {},
             "display-name": "<varname>&lt;compute_img_capability_schema_name></varname>",
             "freeform-tags": {},
             "id": "ocid1.computeimgcapschema.oc1.phx.<varname>&lt;unique_ID></varname>",
             "image-id": "ocid1.image.oc1.phx.<varname>&lt;unique_ID></varname>",
             "schema-data": {
                 "Storage.ParaVirtualization.EncryptionInTransit": {
                     "default-value": false,
                     "descriptor-type": "boolean",
                     "source": "IMAGE"
                 }
             },
             "time-created": "2021-07-01T22:42:56.140000+00:00"
         },
         "etag": "<varname>&lt;etag></varname>"
     }

5. Pour mettre à jour le schéma de fonctionnalités d'image, exécutez la commande suivante :

   oci compute image-capability-schema update --image-capability-schema-id <image_capability_schema_OCID> --schema-data file://<schema_data_file>.json

   <schema_data_file> est le chemin du fichier .json qui contient les éléments de schéma à mettre à jour.