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

In diesem Beispiel wird gezeigt, 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 im vorherigen Schritt abgerufenen OCID und dem Versionsnamen des 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 führen Sie dann die folgenden Schritte aus:

   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 eine Imagefunktion verwendet, führen Sie den folgenden Befehl durch:

   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 Imagefunktionsschema-OCID.

   • 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, die die zu aktualisierenden Schemaelemente enthält, 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 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, in der die zu aktualisierenden Schemaelemente enthalten sind.