Offers - Create Or Update

Créez ou mettez à jour l’offre.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Subscriptions.Admin/offers/{offer}?api-version=2015-11-01

Paramètres URI

Name In Required Type Description
offer
path True
  • string

Nom d’une offre.

resourceGroupName
path True
  • string

Groupe de ressources sous lequel la ressource se trouve.

subscriptionId
path True
  • string

Informations d’identification d’abonnement qui identifient de manière unique Microsoft Azure abonnement. L’ID d’abonnement forme une partie de l’URI pour chaque appel de service.

api-version
query True
  • string

Version de l’API cliente.

Corps de la demande

Name Type Description
location
  • string

Emplacement de la ressource

properties.addonPlans

Références aux plans additionnels qu’un locataire peut éventuellement acquérir dans le cadre de l’offre.

properties.basePlanIds
  • string[]

Identificateurs des plans de base qui deviennent immédiatement disponibles pour le locataire lorsqu’un locataire s’abonne à l’offre.

properties.description
  • string

Description de l’offre.

properties.displayName
  • string

Nom d’affichage de l’offre.

properties.externalReferenceId
  • string

Identificateur de référence externe.

properties.maxSubscriptionsPerAccount
  • integer

Nombre maximal d’abonnements par compte.

properties.name
  • string

Nom de l’offre.

properties.state

Offre un état d’accessibilité.

properties.subscriptionCount
  • integer

Nombre actuel d’abonnements.

Réponses

Name Type Description
200 OK

Ok

201 Created

Date de création

Other Status Codes

erreur inattendue

Sécurité

azure_auth

Azure Active Directory le Flow OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

Create or update the offer.

Sample Request

PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/RG1/providers/Microsoft.Subscriptions.Admin/offers/sampleoffer1?api-version=2015-11-01
{
  "properties": {
    "name": "testOffer1",
    "displayName": "Test Offer",
    "description": "This is a test Offer",
    "state": "Private",
    "subscriptionCount": 0,
    "maxSubscriptionsPerAccount": 100,
    "basePlanIds": [
      "/subscriptions/8ab2551d-41e5-489b-9273-1cdf1cbc7dc6/resourceGroups/Plans/providers/Microsoft.Subscriptions.Admin/plans/testplan"
    ]
  }
}

Sample Response

{
  "id": "/subscriptions/8ab2551d-41e5-489b-9273-1cdf1cbc7dc6/resourceGroups/testrg/providers/Microsoft.Subscriptions.Admin/offers/testOffer1",
  "name": "testOffer1",
  "type": "Microsoft.Subscriptions.Admin/offers",
  "location": "local",
  "properties": {
    "name": "testOffer1",
    "displayName": "Test Offer",
    "description": "This is a test Offer",
    "state": "Private",
    "subscriptionCount": 0,
    "maxSubscriptionsPerAccount": 100,
    "basePlanIds": [
      "/subscriptions/8ab2551d-41e5-489b-9273-1cdf1cbc7dc6/resourceGroups/Plans/providers/Microsoft.Subscriptions.Admin/plans/testplan"
    ]
  }
}
{
  "id": "/subscriptions/8ab2551d-41e5-489b-9273-1cdf1cbc7dc6/resourceGroups/testrg/providers/Microsoft.Subscriptions.Admin/offers/testOffer1",
  "name": "testOffer1",
  "type": "Microsoft.Subscriptions.Admin/offers",
  "location": "local",
  "properties": {
    "name": "testOffer1",
    "displayName": "Test Offer",
    "description": "This is a test Offer",
    "state": "Private",
    "subscriptionCount": 0,
    "maxSubscriptionsPerAccount": 100,
    "basePlanIds": [
      "/subscriptions/8ab2551d-41e5-489b-9273-1cdf1cbc7dc6/resourceGroups/Plans/providers/Microsoft.Subscriptions.Admin/plans/testplan"
    ]
  }
}

Définitions

AccessibilityState

Représente l’état de l’offre

AddonPlanDefinition

Contient le nom du plan souhaité à lier ou dissocier d’une offre.

Error

Réponse d’erreur.

ErrorDefinition

Définition de l’erreur.

Offer

Représente une offre de services par rapport à laquelle un abonnement peut être créé.

AccessibilityState

Représente l’état de l’offre

Name Type Description
Decommissioned
  • string

L’offre ou le plan est désactivé. Les abonnements actuels peuvent toujours le consommer, mais les nouveaux abonnements ne le peuvent pas.

Private
  • string

L’offre ou le plan est privé. Seul un administrateur peut le voir et le gérer.

Public
  • string

L’offre ou le plan est public. Les utilisateurs peuvent le voir et s’y abonner.

AddonPlanDefinition

Contient le nom du plan souhaité à lier ou dissocier d’une offre.

Name Type Description
maxAcquisitionCount
  • integer

Nombre maximal d’instances qui peuvent être acquises par un seul abonnement. S’il n’est pas spécifié, la valeur par défaut est 1.

planId
  • string

Identificateur de plan.

Error

Réponse d’erreur.

Name Type Description
error

Détails de l’erreur.

ErrorDefinition

Définition de l’erreur.

Name Type Description
code
  • string

Code d’erreur spécifique au service qui sert de sous-état du code d’erreur HTTP.

details

Détails de l’erreur interne.

message
  • string

Description de l'erreur.

Offer

Représente une offre de services par rapport à laquelle un abonnement peut être créé.

Name Type Description
id
  • string

URI de la ressource.

location
  • string

Emplacement de la ressource

name
  • string

Nom de la ressource.

properties.addonPlans

Références aux plans additionnels qu’un locataire peut éventuellement acquérir dans le cadre de l’offre.

properties.basePlanIds
  • string[]

Identificateurs des plans de base qui deviennent immédiatement disponibles pour le locataire lorsqu’un locataire s’abonne à l’offre.

properties.description
  • string

Description de l’offre.

properties.displayName
  • string

Nom d’affichage de l’offre.

properties.externalReferenceId
  • string

Identificateur de référence externe.

properties.maxSubscriptionsPerAccount
  • integer

Nombre maximal d’abonnements par compte.

properties.name
  • string

Nom de l’offre.

properties.state

Offre un état d’accessibilité.

properties.subscriptionCount
  • integer

Nombre actuel d’abonnements.

tags
  • object

Liste de paires clé-valeur.

type
  • string

Type de ressource.