ReceivedSharesClient.CreateOrReplaceReceivedShare 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.
[Méthode de protocole] Créer ou remplacer un partage reçu.
- Cette méthode de protocole permet la création explicite de la demande et le traitement de la réponse pour les scénarios avancés.
public virtual Azure.Operation<BinaryData> CreateOrReplaceReceivedShare (Azure.WaitUntil waitUntil, string receivedShareId, Azure.Core.RequestContent content, Azure.RequestContext context = default);
abstract member CreateOrReplaceReceivedShare : Azure.WaitUntil * string * Azure.Core.RequestContent * Azure.RequestContext -> Azure.Operation<BinaryData>
override this.CreateOrReplaceReceivedShare : Azure.WaitUntil * string * Azure.Core.RequestContent * Azure.RequestContext -> Azure.Operation<BinaryData>
Public Overridable Function CreateOrReplaceReceivedShare (waitUntil As WaitUntil, receivedShareId As String, content As RequestContent, Optional context As RequestContext = Nothing) As Operation(Of BinaryData)
Paramètres
- waitUntil
- WaitUntil
Completed si la méthode doit attendre pour retourner jusqu’à ce que l’opération de longue durée soit terminée sur le service ; Started si elle doit être retournée après le démarrage de l’opération. Pour plus d’informations sur les opérations de longue durée, consultez Exemples d’opérations de Long-Running Azure.Core.
- receivedShareId
- String
ID du partage reçu.
- content
- RequestContent
Contenu à envoyer en tant que corps de la demande.
- context
- RequestContext
Contexte de la demande, qui peut remplacer les comportements par défaut du pipeline client par appel.
Retours
Operation représentant une opération asynchrone sur le service.
Exceptions
receivedShareId
ou content
est null.
receivedShareId
est une chaîne vide et devait être non vide.
Le service a retourné un code de status non réussi.
Exemples
Cet exemple montre comment appeler CreateOrReplaceReceivedShare avec les paramètres requis et demander le contenu, et comment analyser le résultat.
var credential = new DefaultAzureCredential();
var endpoint = new Uri("<https://my-service.azure.com>");
var client = new ReceivedSharesClient(endpoint, credential);
var data = new {
properties = new {},
shareKind = "InPlace",
};
var operation = client.CreateOrReplaceReceivedShare(WaitUntil.Completed, "<receivedShareId>", RequestContent.Create(data));
BinaryData responseData = operation.Value;
JsonElement result = JsonDocument.Parse(responseData.ToStream()).RootElement;
Console.WriteLine(result.GetProperty("shareKind").ToString());
Console.WriteLine(result.ToString());
Cet exemple montre comment appeler CreateOrReplaceReceivedShare avec tous les paramètres et demander le contenu, et comment analyser le résultat.
var credential = new DefaultAzureCredential();
var endpoint = new Uri("<https://my-service.azure.com>");
var client = new ReceivedSharesClient(endpoint, credential);
var data = new {
properties = new {
assetStoreKind = "AdlsGen2Account",
displayName = "<displayName>",
shareStatus = "Detached",
sink = new {
properties = new {
containerName = "<containerName>",
folder = "<folder>",
mountPath = "<mountPath>",
},
storeKind = "AdlsGen2Account",
storeReference = new {
referenceName = "<referenceName>",
type = "ArmResourceReference",
},
},
},
shareKind = "InPlace",
};
var operation = client.CreateOrReplaceReceivedShare(WaitUntil.Completed, "<receivedShareId>", RequestContent.Create(data));
BinaryData responseData = operation.Value;
JsonElement result = JsonDocument.Parse(responseData.ToStream()).RootElement;
Console.WriteLine(result.GetProperty("shareKind").ToString());
Console.WriteLine(result.GetProperty("id").ToString());
Console.WriteLine(result.GetProperty("type").ToString());
Remarques
Mettre à jour les modifications apportées à un partage reçu
Vous trouverez ci-dessous le schéma JSON pour les charges utiles de requête et de réponse.
Corps de la demande :
InPlaceReceivedShare
Schéma pourInPlaceReceivedShare
:{
properties: {
assetLocation: string, # Optional. Location of the shared Asset.
assetStoreKind: "AdlsGen2Account" | "BlobAccount", # Optional. The types of asset.
createdAt: string (ISO 8601 Format), # Optional. Time at which the received share was created. Represented in the standard date-time format as defined by [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339)
displayName: string, # Optional. Received Share Name
expirationDate: string (ISO 8601 Format), # Optional. The expiration date of the received share. Represented in the standard date-time format as defined by [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339)
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.
sharedAt: string (ISO 8601 Format), # Optional. Time at which the sent share was shared. Represented in the standard date-time format as defined by [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339)
shareStatus: "Detached" | "Attached", # Optional. Share status.
sink: {
storeKind: "AdlsGen2Account" | "BlobAccount", # Required. The types of asset.
storeReference: {
referenceName: string, # Optional. Reference name for resource associated with the sink or artifact.
type: "ArmResourceReference", # Optional. Defines the type of resource being shared
}, # Required. A Store Reference for an artifact or sink.
}, # Optional. Holds details on the destination of the mapped artifact
state: "Unknown" | "Succeeded" | "Creating" | "Deleting" | "Moving" | "Failed", # Optional. State of the resource
}, # Required. Properties of in place received share.
shareKind: InPlace, # Required. Defines the supported types for share.
id: string, # Optional. The unique id of the resource.
type: string, # Optional. Type of the resource.
}
Corps de réponse :
InPlaceReceivedShare
Schéma pourInPlaceReceivedShare
:{
properties: {
assetLocation: string, # Optional. Location of the shared Asset.
assetStoreKind: "AdlsGen2Account" | "BlobAccount", # Optional. The types of asset.
createdAt: string (ISO 8601 Format), # Optional. Time at which the received share was created. Represented in the standard date-time format as defined by [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339)
displayName: string, # Optional. Received Share Name
expirationDate: string (ISO 8601 Format), # Optional. The expiration date of the received share. Represented in the standard date-time format as defined by [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339)
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.
sharedAt: string (ISO 8601 Format), # Optional. Time at which the sent share was shared. Represented in the standard date-time format as defined by [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339)
shareStatus: "Detached" | "Attached", # Optional. Share status.
sink: {
storeKind: "AdlsGen2Account" | "BlobAccount", # Required. The types of asset.
storeReference: {
referenceName: string, # Optional. Reference name for resource associated with the sink or artifact.
type: "ArmResourceReference", # Optional. Defines the type of resource being shared
}, # Required. A Store Reference for an artifact or sink.
}, # Optional. Holds details on the destination of the mapped artifact
state: "Unknown" | "Succeeded" | "Creating" | "Deleting" | "Moving" | "Failed", # Optional. State of the resource
}, # Required. Properties of in place received share.
shareKind: InPlace, # Required. Defines the supported types for share.
id: string, # Optional. The unique id of the resource.
type: string, # Optional. Type of the resource.
}
S’applique à
Azure SDK for .NET