ReceivedSharesClient.CreateAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Créez un partage reçu dans le compte donné.
public virtual System.Threading.Tasks.Task<Azure.Response> CreateAsync (string receivedShareName, Azure.Core.RequestContent content, Azure.RequestContext context = default);
abstract member CreateAsync : string * Azure.Core.RequestContent * Azure.RequestContext -> System.Threading.Tasks.Task<Azure.Response>
override this.CreateAsync : string * Azure.Core.RequestContent * Azure.RequestContext -> System.Threading.Tasks.Task<Azure.Response>
Public Overridable Function CreateAsync (receivedShareName As String, content As RequestContent, Optional context As RequestContext = Nothing) As Task(Of Response)
Paramètres
- receivedShareName
- String
Nom du partage reçu.
- content
- RequestContent
Contenu à envoyer en tant que corps de la demande. Les détails du schéma du corps de la demande se trouvent dans la section Remarques ci-dessous.
- context
- RequestContext
Contexte de requête, qui peut remplacer les comportements par défaut du pipeline client par appel.
Retours
Réponse retournée par le service. Les détails du schéma du corps de la réponse se trouvent dans la section Remarques ci-dessous.
Exceptions
receivedShareName
ou content
est null.
receivedShareName
est une chaîne vide, et on s’attendait à ce qu’elle ne soit pas vide.
Le service a retourné un code de status non réussi.
Exemples
Cet exemple montre comment appeler CreateAsync avec les paramètres requis et demander le contenu, et comment analyser le résultat.
var credential = new DefaultAzureCredential();
var client = new ReceivedSharesClient("<https://my-service.azure.com>", credential);
var data = new {
shareKind = "InPlace",
properties = new {
collection = new {
referenceName = "<CollectionReferenceName>",
type = "<CollectionType>",
},
invitationId = "<InPlaceReceivedSharePropertiesInvitationId>",
sentShareLocation = "<InPlaceReceivedSharePropertiesSentShareLocation>",
},
};
Response response = await client.CreateAsync("<receivedShareName>", RequestContent.Create(data));
JsonElement result = JsonDocument.Parse(response.ContentStream).RootElement;
Console.WriteLine(result.ToString());
Cet exemple montre comment appeler CreateAsync avec tous les paramètres et demander le contenu, et comment analyser le résultat.
var credential = new DefaultAzureCredential();
var client = new ReceivedSharesClient("<https://my-service.azure.com>", credential);
var data = new {
shareKind = "InPlace",
properties = new {
collection = new {
referenceName = "<CollectionReferenceName>",
type = "<CollectionType>",
},
expirationDate = "<2022-05-10T14:57:31.2311892-04:00>",
invitationId = "<InPlaceReceivedSharePropertiesInvitationId>",
sentShareDescription = "<InPlaceReceivedSharePropertiesSentShareDescription>",
sentShareLocation = "<InPlaceReceivedSharePropertiesSentShareLocation>",
},
};
Response response = await client.CreateAsync("<receivedShareName>", RequestContent.Create(data));
JsonElement result = JsonDocument.Parse(response.ContentStream).RootElement;
Console.WriteLine(result.GetProperty("id").ToString());
Console.WriteLine(result.GetProperty("name").ToString());
Console.WriteLine(result.GetProperty("type").ToString());
Console.WriteLine(result.GetProperty("shareKind").ToString());
Remarques
Créer un partage reçu
Vous trouverez ci-dessous le schéma JSON pour les charges utiles de demande et de réponse.
Corps de la demande :
InPlaceReceivedShare
Schéma pourInPlaceReceivedShare
:{
shareKind: InPlace, # Required. Defines the supported types for share.
id: string, # Optional. The resource id of the resource.
name: string, # Optional. Name of the resource.
type: string, # Optional. Type of the resource.
properties: {
collection: {
referenceName: string, # Required. Gets or sets the reference name.
type: string, # Required. Gets or sets the reference type property.
}, # Required. Reference to a Collection.
createdAt: string (ISO 8601 Format), # Optional. Time at which the received share was created.
expirationDate: string (ISO 8601 Format), # Optional. The expiration date of the received share.
invitationId: string, # Required. The invitation id.
provisioningState: "Unknown" | "Succeeded" | "Creating" | "Deleting" | "Moving" | "Failed" | "SoftDeleting" | "SoftDeleted" | "SourceMoved" | "SourceDeleted" | "TargetMoved" | "TargetDeleted", # Optional. Provisioning status of the resource
receivedShareStatus: "Active" | "Reinstating" | "Revoked" | "Revoking" | "RevokeFailed" | "ReinstateFailed" | "SourceDeleted", # Optional. received share status
receiverEmail: string, # Optional. Email of the user/receiver who received the sent share invitation
receiverName: string, # Optional. Name of the user/receiver who received the sent share invitation
receiverTenantName: string, # Optional. Tenant name of the user/receiver who received the sent share invitation
senderEmail: string, # Optional. Email of the sender who created the sent share invitation
senderName: string, # Optional. Name of the sender who created the sent share invitation
senderTenantName: string, # Optional. Tenant name of the sender who created the sent share invitation
sentShareDescription: string, # Optional. Share description.
sentShareLocation: string, # Required. Sent share location.
sharedAt: string (ISO 8601 Format), # Optional. Time at which the sent share was shared.
shareName: string, # Optional. Name of the share
}, # Required. Properties of in place received share.
}
Corps de réponse :
InPlaceReceivedShare
Schéma pourInPlaceReceivedShare
:{
shareKind: InPlace, # Required. Defines the supported types for share.
id: string, # Optional. The resource id of the resource.
name: string, # Optional. Name of the resource.
type: string, # Optional. Type of the resource.
properties: {
collection: {
referenceName: string, # Required. Gets or sets the reference name.
type: string, # Required. Gets or sets the reference type property.
}, # Required. Reference to a Collection.
createdAt: string (ISO 8601 Format), # Optional. Time at which the received share was created.
expirationDate: string (ISO 8601 Format), # Optional. The expiration date of the received share.
invitationId: string, # Required. The invitation id.
provisioningState: "Unknown" | "Succeeded" | "Creating" | "Deleting" | "Moving" | "Failed" | "SoftDeleting" | "SoftDeleted" | "SourceMoved" | "SourceDeleted" | "TargetMoved" | "TargetDeleted", # Optional. Provisioning status of the resource
receivedShareStatus: "Active" | "Reinstating" | "Revoked" | "Revoking" | "RevokeFailed" | "ReinstateFailed" | "SourceDeleted", # Optional. received share status
receiverEmail: string, # Optional. Email of the user/receiver who received the sent share invitation
receiverName: string, # Optional. Name of the user/receiver who received the sent share invitation
receiverTenantName: string, # Optional. Tenant name of the user/receiver who received the sent share invitation
senderEmail: string, # Optional. Email of the sender who created the sent share invitation
senderName: string, # Optional. Name of the sender who created the sent share invitation
senderTenantName: string, # Optional. Tenant name of the sender who created the sent share invitation
sentShareDescription: string, # Optional. Share description.
sentShareLocation: string, # Required. Sent share location.
sharedAt: string (ISO 8601 Format), # Optional. Time at which the sent share was shared.
shareName: string, # Optional. Name of the share
}, # Required. Properties of in place received share.
}
S’applique à
Azure SDK for .NET