Modification des fonctionnalités d'image pour les images personnalisées
Modifier les fonctionnalités d'une image personnalisée.
- Accédez à la page de liste Images personnalisées Compute. Si vous avez besoin d'aide pour trouver la page de liste, reportez-vous à Liste des images personnalisées.
- Sélectionnez l'image personnalisée qui vous intéresse.
-
Modifiez les fonctionnalités d'image à configurer. Pour plus de détails sur chaque fonctionnalité d'image, reportez-vous à Eléments de schéma.
-
Sélectionnez Enregistrer les modifications.
Pour obtenir des informations sur l'utilisation de l'interface de ligne de commande, reportez-vous à Interface de ligne de commande (CLI). Pour utiliser les schémas de fonctionnalités d'image à l'aide de l'interface de ligne de commande, ouvrez une invite de commande et exécutez l'une des commandes suivantes.
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 de syntaxe
Cet exemple montre comment utiliser l'interface de ligne de commande pour mettre à jour le schéma de fonctionnalités d'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).
-
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><version_name></varname>", "defined-tags": {}, "display-name": "OCI.ComputeGlobalImageCapabilitySchema", "freeform-tags": {}, "id": "ocid1.computeglobalimgcapschema.oc1.phx.<varname><unique_ID></varname>", "time-created": "2020-03-23T19:20:39.656000+00:00" } ], "opc-next-page": "<varname><unique_ID></varname>" }
- En utilisant l'OCID et le nom de version du schéma de fonctionnalités d'image global que vous avez extrait à l'étape précédente, exécutez la commande suivante pour obtenir le schéma de fonctionnalités d'image global :
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.
-
Localisez l'élément de schéma à mettre à jour, puis procédez comme suit :
- Copiez l'élément de schéma à mettre à jour. Cet exemple utilise l'élément de schéma Storage.ParaVirtualization.EncryptionInTransit.
-
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" } }
- Enregistrez les éléments de schéma mis à jour en tant que fichier
.json
.
-
Pour vérifier si l'image utilise déjà la 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 la fonctionnalité d'image, exécutez la commande suivante pour en créer :
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 d'accès au fichier
.json
contenant 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><unique_ID></varname>", "compute-global-image-capability-schema-id": "ocid1.computeglobalimgcapschema.oc1.phx.<varname><unique_ID></varname>", "compute-global-image-capability-schema-version-name": "<varname><version_name></varname>", "defined-tags": {}, "display-name": "<varname><compute_img_capability_schema_name></varname>", "freeform-tags": {}, "id": "ocid1.computeimgcapschema.oc1.phx.<varname><unique_ID></varname>", "image-id": "ocid1.image.oc1.phx.<varname><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><etag></varname>" }
-
-
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 d'accès au fichier
.json
contenant les éléments de schéma à mettre à jour.
-
Pour plus d'informations sur l'utilisation de l'API et la signature des demandes, reportez-vous à la documentation relative à l'API REST et à Informations d'identification de sécurité. Pour plus d'informations sur les kits SDK, reportez-vous à Kits SDK et interface de ligne de commande.
Utilisez les opérations d'API suivantes pour travailler sur les schémas de fonctionnalités d'image :
- ListComputeGlobalImageCapabilitySchemas
- ListComputeGlobalImageCapabilitySchemaVersions
- GetComputeGlobalImageCapabilitySchema
- GetComputeGlobalImageCapabilitySchemaVersion
- ListComputeImageCapabilitySchemas
- GetComputeImageCapabilitySchema
- CreateComputeImageCapabilitySchema
- UpdateComputeImageCapabilitySchema
- DeleteComputeImageCapabilitySchema
- ChangeComputeImageCapabilitySchemaCompartment