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 IconDeleteRed à 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 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.

The UpdateImage command returns the following elements:

  • Image: Information about the OMI.

  • ResponseContext: Information about the context of the response.

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.