Imagefunktionen für benutzerdefinierte Images bearbeiten

CLI-Beispiele

So listen Sie das globale Imagefunktionsschema auf:

oci compute global-image-capability-schema list

So listen Sie die Versionen für globale Imagefunktionsschemas auf:

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

So rufen Sie die Version für globale Imagefunktionsschemas ab:

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>

So listen Sie die Imagefunktionsschemas im angegebenen Compartment auf:

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

So rufen Sie das Imagefunktionsschema für die angegebene ID ab:

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

So aktualisieren Sie das angegebene Imagefunktionsschema:

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

So erstellen Sie ein Imagefunktionsschema:

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>

Wenn Sie das Schema erstellen, geben Sie die Image-OCID für das benutzerdefinierte Image an, auf das Sie das Imagefunktionsschema anwenden möchten.

So löschen Sie das angegebene Imagefunktionsschema:

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

Verwendungsbeispiel

Dieses Beispiel zeigt, wie Sie mit der CLI das Imagefunktionsschema für ein benutzerdefiniertes Image aktualisieren. Informationen zur Verwendung der CLI finden Sie unter Befehlszeilenschnittstelle (CLI).

1. Öffnen Sie eine Eingabeaufforderung, und führen Sie den folgenden Befehl aus, um das aktuelle globale Schema für die Region abzurufen:

   oci compute global-image-capability-schema list

   Das Ergebnis sieht in etwa folgendermaßen aus:

   {
       "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. Führen Sie mit der OCID und dem Versionsnamen des im vorherigen Schritt abgerufenen globalen Imagefunktionsschemas den folgenden Befehl aus, um das globale Imagefunktionsschema abzurufen:

   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>

   Die Antwort enthält das globale Imagefunktionsschema.

3. Suchen Sie das Schemaelement, das Sie aktualisieren möchten, und gehen Sie dann wie folgt vor:

   1. Kopieren Sie das Schemaelement, das Sie aktualisieren möchten. In diesem Beispiel wird das Schemaelement Storage.ParaVirtualization.EncryptionInTransit verwendet.

   2. Wenn das Schemaelement ein source-Feld enthält, ändern Sie den Wert von GLOBAL in IMAGE. Beispiel:

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

   3. Speichern Sie die aktualisierten Schemaelemente als .json-Datei.

4. Um zu prüfen, ob das Image bereits die Bildfunktion verwendet, führen Sie den folgenden Befehl aus:

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

   • Wenn das Image die Imagefunktion verwendet, enthält die Antwort eine Zeile wie die folgende:

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

     Die Antwort enthält auch die OCID des Imagefunktionsschemas.

   • Wenn das Image keine Imagefunktion verwendet, erstellen Sie ein Imagefunktionsschema für das Image, indem Sie den folgenden Befehl ausführen:

     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> ist der Pfad zur Datei .json mit den Schemaelementen, die Sie aktualisieren möchten und die Sie im vorherigen Schritt erstellt haben.

     Das Ergebnis sieht in etwa folgendermaßen aus:

     {
         "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. Um das Imagefunktionsschema zu aktualisieren, führen Sie den folgenden Befehl aus:

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

   <schema_data_file> ist der Pfad zur Datei .json mit den Schemaelementen, die Sie aktualisieren möchten.