Modifier les attributs d’une OMI

Vous pouvez modifier les attributs d’une image machine OUTSCALE (OMI), tels que sa description, ses permissions ou sa confidentialité.

Vous pouvez également partager une OUTSCALE machine image (OMI) privée que vous avez créée, ou que vous avez copiée, avec un ou plusieurs comptes dans la même Région.

Partager une OMI avec d’autres comptes leur permet d’accéder à cette OMI et de créer d’autres machines virtuelles (VM) similaires à partir de celle-ci. Vous pouvez copier une OMI qu’un autre compte a partagé avec vous, à condition que les deux comptes soient dans la même Région. Vous pouvez également partager une copie que vous avez créée depuis une OMI partagée avec d’autres comptes. Pour en savoir plus, voir Copier une OMI.

Vous pouvez gérer qui peut accéder à une OMI en ajoutant ou en rentirant des permissions. Pour obtenir des informations sur les comptes qui ont les permissions pour une OMI, voir Obtenir des informations sur vos OMI > Obtenir des informations sur un attribut d’une OMI.

Modifier les attributs d’une image avec Cockpit v2

Modifier les permissions d’une image

  1. Cliquez dans le dashboard Images pour faire apparaître des cases à cocher.

  2. Cochez la case de l’image que vous voulez partager.
    L’image est sélectionnée et un menu d’actions apparaît.

  3. Cliquez sur IconLock Modifier les permissions.
    La boîte de dialogue MODIFIER LES PERMISSIONS D’UNE IMAGE apparaît.

    Une liste des ID de comptes des utilisateurs autorisés à utiliser l’image apparaît, le cas échéant.

  4. Pour partager l’image sélectionnée avec un ou plusieurs utilisateurs, cliquez sur IconAddFull Ajouter et tapez leurs IDs séparés par une virgule dans le champ Account ID.

    Pour retirer les permissions à un utilisateur, cliquez sur IconStateTerminated à côté de son ID.

  5. Cliquez sur Modifier.
    L’image est partagée avec les utilisateurs que vous avez spécifiés.

Modifier la confidentialité d’une image

  1. Cliquez dans le dashboard Images pour faire apparaître des cases à cocher.

  2. Cochez la case de l’image dont vous voulez modifier la confidentialité.
    L’image est sélectionnée et un menu d’actions apparaît.

  3. Cliquez sur IconLock Modifier la confidentialité.
    La boîte de dialogue MODIFIER LA CONFIDENTIALITÉ D’UNE IMAGE apparaît.

  4. Si vous voulez rendre votre image publique, activez Cloud public.

  5. Si vous voulez que votre image reste privée, laissez Cloud public désactivé.

  6. Cliquez sur Modifier.
    La confidentialité de l’image est modifiée.

Modifier les attributs d’une OMI avec Cockpit v1

Cockpit v1 n’est plus corrigé ni supporté. Cockpit v1 n’est plus disponible sur la Région cloudgouv-eu-west-1. Pour en savoir plus, voir Politique de fin de vie.

Modifier la description d’une OMI

  1. Cliquez sur Calcul > OUTSCALE machine images.

  2. Cliquez sur l’OMI dont vous voulez modifier la description.
    L’OMI est sélectionnée.

  3. Cliquez sur Modifier .
    La boîte de dialogue MODIFIER LA DESCRIPTION apparaît.

  4. Modifiez la description dans le champ de texte.

  5. Cliquez sur Modifier pour valider.
    La description de l’OMI est modifiée.

Gérer les permissions pour une OMI

  1. Cliquez sur Calcul > Outscale machine images.

  2. Cliquez sur l’OMI que vous souhaitez partager.
    L’OMI est sélectionnée.

  3. Cliquez sur Autorisations .
    La boîte de dialogue AUTORISATIONS POUR UNE OMI apparaît.

    Une liste des ID de comptes autorisés à utiliser l’OMI apparaît, le cas échéant.

  4. Pour partager l’OMI sélectionnée avec un ou plusieurs comptes, tapez leurs IDs séparés par une virgule dans le champ Account ID.

    Pour retirer les permissions à un compte :

    1. Sélectionnez un ou plusieurs ID de comptes.

    2. Cliquez sur Retirer pour valider.

  5. Cliquez sur Partager pour valider.
    L’OMI est partagée avec les comptes que vous avez spécifiés.

Modifier les attributs d’une OMI avec OSC CLI

À ce jour, cette section est disponible en anglais uniquement.

The UpdateImage command modifies the access permissions for an OUTSCALE machine image (OMI).
You must specify either the Additions or the Removals parameter.
After sharing an OMI with an account, the other account can create a copy of it that they own. For more information about copying OMIs, see CreateImage.

Request sample: Adding permission
$ osc-cli api UpdateImage --profile "default" \
    --ImageId "ami-12345678" \
    --PermissionsToLaunch '{
        "Additions": {
          "AccountIds": ["987654321098"],
        },
      }'
Request sample: Removing permission
$ osc-cli api UpdateImage --profile "default" \
    --ImageId "ami-12345678" \
    --PermissionsToLaunch '{
        "Removals": {
          "AccountIds": ["987654321098"],
        },
      }'
Request sample: Making an image public to everyone
$ osc-cli api UpdateImage --profile "default" \
    --ImageId "ami-12345678" \
    --PermissionsToLaunch '{
        "Additions": {
          "GlobalPermission": True,
        },
      }'
Request sample: Making an image private to everyone
$ osc-cli api UpdateImage --profile "default" \
    --ImageId "ami-12345678" \
    --PermissionsToLaunch '{
        "Removals": {
          "GlobalPermission": True,
        },
      }'

This command contains the following attributes that you need to specify:

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • ImageId: The ID of the OMI you want to modify.

  • PermissionsToLaunch: Information about the permissions for the resource.
    Specify either the Additions or the Removals parameter.

    • Additions: (optional) Permissions for the resource.

      • AccountIds: (optional) One or more account IDs that the permission is associated with.

      • GlobalPermission: (optional) A global permission for all accounts.
        (Request) Set this parameter to true to make the resource public (if the parent parameter is Additions) or to make the resource private (if the parent parameter is Removals).
        (Response) If true, the resource is public. If false, the resource is private.

    • Removals: (optional) Permissions for the resource.

      • AccountIds: (optional) One or more account IDs that the permission is associated with.

      • GlobalPermission: (optional) A global permission for all accounts.
        (Request) Set this parameter to true to make the resource public (if the parent parameter is Additions) or to make the resource private (if the parent parameter is Removals).
        (Response) If true, the resource is public. If false, the resource is private.

The UpdateImage command returns the following elements:

  • Image: Information about the OMI.

    • AccountAlias: The account alias of the owner of the OMI.

    • AccountId: The account ID of the owner of the OMI.

    • Architecture: The architecture of the OMI.

    • BlockDeviceMappings: One or more block device mappings.

      • Bsu: Information about the BSU volume to create.

        • DeleteOnVmDeletion: By default or if set to true, the volume is deleted when terminating the VM. If false, the volume is not deleted when terminating the VM.

        • Iops: The number of I/O operations per second (IOPS). This parameter must be specified only if you create an io1 volume. The maximum number of IOPS allowed for io1 volumes is 13000 with a maximum performance ratio of 300 IOPS per gibibyte.

        • SnapshotId: The ID of the snapshot used to create the volume.

        • VolumeSize: The size of the volume, in gibibytes (GiB).
          If you specify a snapshot ID, the volume size must be at least equal to the snapshot size.
          If you specify a snapshot ID but no volume size, the volume is created with a size similar to the snapshot one.

        • VolumeType: The type of the volume (standard | io1 | gp2). If not specified in the request, a standard volume is created.
          For more information about volume types, see About Volumes > Volume Types and IOPS.

      • DeviceName: The device name for the volume. For a root device, you must use /dev/sda1. For other volumes, you must use /dev/sdX, /dev/sdXX, /dev/xvdX, or /dev/xvdXX (where the first X is a letter between b and z, and the second X is a letter between a and z).

      • VirtualDeviceName: The name of the virtual device (ephemeralN).

    • CreationDate: The date and time of creation of the OMI, in ISO 8601 date-time format.

    • Description: The description of the OMI.

    • FileLocation: The location from which the OMI files were created.

    • ImageId: The ID of the OMI.

    • ImageName: The name of the OMI.

    • ImageType: The type of the OMI.

    • PermissionsToLaunch: Permissions for the resource.

      • AccountIds: One or more account IDs that the permission is associated with.

      • GlobalPermission: A global permission for all accounts.
        (Request) Set this parameter to true to make the resource public (if the parent parameter is Additions) or to make the resource private (if the parent parameter is Removals).
        (Response) If true, the resource is public. If false, the resource is private.

    • ProductCodes: The product codes associated with the OMI.

    • RootDeviceName: The name of the root device.

    • RootDeviceType: The type of root device used by the OMI (always bsu).

    • State: The state of the OMI (pending | available | failed).

    • StateComment: Information about the change of state.

      • StateCode: The code of the change of state.

      • StateMessage: A message explaining the change of state.

    • Tags: One or more tags associated with the OMI.

      • Key: The key of the tag, with a minimum of 1 character.

      • Value: The value of the tag, between 0 and 255 characters.

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample: Adding permission
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "Image": {
    "StateComment": {},
    "State": "available",
    "RootDeviceType": "bsu",
    "RootDeviceName": "/dev/sda1",
    "ProductCodes": [
      "0001"
    ],
    "PermissionsToLaunch": {
      "GlobalPermission": false,
      "AccountIds": [
        "987654321098"
      ]
    },
    "AccountId": "123456789012",
    "Tags": [],
    "Description": "",
    "ImageId": "ami-12345678",
    "BlockDeviceMappings": [
      {
        "DeviceName": "/dev/sda1",
        "Bsu": {
          "VolumeType": "standard",
          "DeleteOnVmDeletion": true,
          "VolumeSize": 50,
          "SnapshotId": "snap-12345678"
        }
      }
    ],
    "ImageType": "machine",
    "CreationDate": "2010-10-01T12:34:56.789Z",
    "FileLocation": "123456789012/image-example",
    "Architecture": "x86_64",
    "ImageName": "image-example"
  }
}
Result sample: Removing permission
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "Image": {
    "StateComment": {},
    "State": "available",
    "RootDeviceType": "bsu",
    "RootDeviceName": "/dev/sda1",
    "ProductCodes": [
      "0001"
    ],
    "PermissionsToLaunch": {
      "GlobalPermission": false,
      "AccountIds": []
    },
    "AccountId": "123456789012",
    "Tags": [],
    "Description": "",
    "ImageId": "ami-12345678",
    "BlockDeviceMappings": [
      {
        "DeviceName": "/dev/sda1",
        "Bsu": {
          "VolumeType": "standard",
          "DeleteOnVmDeletion": true,
          "VolumeSize": 50,
          "SnapshotId": "snap-12345678"
        }
      }
    ],
    "ImageType": "machine",
    "CreationDate": "2010-10-01T12:34:56.789Z",
    "FileLocation": "123456789012/image-example",
    "Architecture": "x86_64",
    "ImageName": "image-example"
  }
}
Result sample: Making an image public to everyone
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "Image": {
    "StateComment": {},
    "State": "available",
    "RootDeviceType": "bsu",
    "RootDeviceName": "/dev/sda1",
    "ProductCodes": [
      "0001"
    ],
    "PermissionsToLaunch": {
      "GlobalPermission": true,
      "AccountIds": []
    },
    "AccountId": "123456789012",
    "Tags": [],
    "Description": "",
    "ImageId": "ami-12345678",
    "BlockDeviceMappings": [
      {
        "DeviceName": "/dev/sda1",
        "Bsu": {
          "VolumeType": "standard",
          "DeleteOnVmDeletion": true,
          "VolumeSize": 50,
          "SnapshotId": "snap-12345678"
        }
      }
    ],
    "ImageType": "machine",
    "CreationDate": "2010-10-01T12:34:56.789Z",
    "FileLocation": "123456789012/image-example",
    "Architecture": "x86_64",
    "ImageName": "image-example"
  }
}
Result sample: Making an image private to everyone
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "Image": {
    "StateComment": {},
    "State": "available",
    "RootDeviceType": "bsu",
    "RootDeviceName": "/dev/sda1",
    "ProductCodes": [
      "0001"
    ],
    "PermissionsToLaunch": {
      "GlobalPermission": false,
      "AccountIds": []
    },
    "AccountId": "123456789012",
    "Tags": [],
    "Description": "",
    "ImageId": "ami-12345678",
    "BlockDeviceMappings": [
      {
        "DeviceName": "/dev/sda1",
        "Bsu": {
          "VolumeType": "standard",
          "DeleteOnVmDeletion": true,
          "VolumeSize": 50,
          "SnapshotId": "snap-12345678"
        }
      }
    ],
    "ImageType": "machine",
    "CreationDate": "2010-10-01T12:34:56.789Z",
    "FileLocation": "123456789012/image-example",
    "Architecture": "x86_64",
    "ImageName": "image-example"
  }
}

Modifier les attributs d’une OMI avec AWS CLI

  • Pour modifier les attributs d’une OMI et ajouter ou retirer des permissions, utilisez la commande modify-image-attribute suivant cette syntaxe :

Requête
$ aws ec2 modify-image-attribute \
    --profile YOUR_PROFILE \
    --description NOT_SPECIFIED \
    --image-id ami-12345678 \
    --launch-permission "{\"Add\":[{\"UserId\":\"123456789000\"}]}" \
    --endpoint https://fcu.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

  • image-id : L’ID de l’OMI.

  • (optional) description : La nouvelle description de l’OMI.

  • (optional) launch-permissions : Une ou plusieurs permissions d’accéder et d’utiliser l’OMI. Cet attribut requiert au moins un des deux éléments suivants :

    • Add : Une ou plusieurs permissions à ajouter. Pour ajouter une permission pour un compte, utilisez l’élément UserId.

    • Remove : Une ou plusieurs permissions à retirer. Pour retirer une permission à un compte, utilisez l’élément UserId.

      Vous ne pouvez pas modifier les attributs description et launch-permissions dans la même commande.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

Les attributs de l’OMI sont modifiés.

Pages connexes

Méthodes API correspondantes

AWS™ et Amazon Web Services™ sont des marques de commerce d’Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.

Exporter en PDF