Defines the purpose of a distribution group and lists the available operations for managing it.
Distribution groups provide properties similar to anti-affinity scaling. Distribution groups are available for vDCs that are based on Oracle VM Server for SPARC virtualization technology.
The APIs and CLI provide operations for:
Use either the cloud infrastructure API actions or the cloud infrastructure CLI command to perform these operations.
Describes a distribution group and the rules for the vServers in it.
You can create a distribution group for your account and define its size. To assign a vServer to a distribution group, you must create the vServer. The size of the distribution group represents the minimum amount of anti-affinity desired for running vServers in the distribution group.
The rules for a distribution group rules are applied every time a vServer in the distribution group is started or a vServer is created. The rules enforce the following behavior:
When the number of running vServers in the distribution group does not exceed the size of the distribution group, all running vServers are distributed in a separate server of the vDC. If a spare server is not available in the vDC, the job fails.
When the number of running vServers in the distribution group exceeds the size of the distribution group, the running vServers are distributed in the servers of the vDC according to the normal account resources capacities.
Other events that can break the rules are stopping, deleting, or migrating a vServer. An alert is displayed for the account and for the incidents report for the vDC.
Lists the API action and CLI command for creating a distribution group.
A cloud user can create distribution groups to associate them with vServers. The membership of a vServer to a distribution group can only be specified at vServer creation time.
When creating a distribution group, a cloud user can specify the size of the distribution group, the default size is 21.
| Cloud Infrastructure API Action | Cloud Infrastructure CLI Command |
|---|---|
Example 3-57 Creating a distribution group using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=CreateDistributionGroup&Version=1&Timestamp=1324407098313&Expires=1324407398313&name=myDistributionGroup&AccessKeyId=AK_1&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST&SignatureMethod=SHA512withRSA&SignatureVersion=1
Example 3-58 Creating a distribution group using the Cloud Infrastructure CLI
iaas-create-distribution-group --base-url https://<EnterpriseControllerHostname>/ -a ak.file --name myDistributionGroup
Lists the API action and CLI command for removing a distribution group.
A cloud user can delete distribution groups that are not associated with vServer.
| Cloud Infrastructure API Action | Cloud Infrastructure CLI Command |
|---|---|
Example 3-59 Deleting a distribution group using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=DeleteDistributionGroup&Version=1&Timestamp=1324407269441&Expires=1324407569441&distributionGroupId=DG-8f81381c-a559-4f5b-b45f-086e605a382b&AccessKeyId=AK_1&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST&SignatureMethod=SHA512withRSA&SignatureVersion=1
Example 3-60 Deleting a distribution group using the Cloud Infrastructure CLI
iaas-delete-distribution-group --base-url https://<EnterpriseControllerHostname>/ --access-key-file ak.file --distribution-group-id DG-3206ed4d-44c9-42c4-8df7-511709a49ead
Lists the API action and CLI command for displaying a distribution group.
A cloud user can get information about the existing distribution groups in an account. The cloud user can restrict the distribution groups included in the result by specifying filters. The result includes a list of the distribution groups found and additional information for each distribution group.
The attributes displayed for each distribution group are:
ID
Name
Description
Status
vServers
Size
The value for a distribution group size greater or equal to the default value is shown as unlimited when using the CLI and APIs.
| Cloud Infrastructure API Action | Cloud Infrastructure CLI Command |
|---|---|
Example 3-61 Viewing distribution groups information using the Cloud Infrastructure API
https://<EnterpriseControllerHostname>/iaas/?Action=DescribeDistributionGroups&Version=1&Timestamp=1324407152926&Expires=1324407452926&AccessKeyId=AK_1&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST&SignatureMethod=SHA512withRSA&SignatureVersion=1
Example 3-62 Viewing distribution groups information using the Cloud Infrastructure CLI
iaas-describe-distribution-groups --base-url https://<EnterpriseControllerHostname>/ -a ~/ak.file -H