/// <summary>
/// Set sensitivity labels on content in Power BI by artifact ID.
/// </summary>
/// <remarks>
/// **Note:** The user must have administrator rights (such as Office 365
/// Global Administrator or Power BI Service Administrator) to call this API.
/// <br/> To set a sensitivity label using this API, the admin user (or
/// the delegated user, if provided) must have the label included in their
/// [label
/// policy](https://docs.microsoft.com/en-us/microsoft-365/compliance/create-sensitivity-labels?view=o365-worldwide).
/// <br/> The admin user (and the delegated user, if provided) must have
/// sufficient [usage rights](https://go.microsoft.com/fwlink/?linkid=2157685)
/// to set labels.<br/>This API allows a maximum of 25 requests per hour.
/// Each request can update up to 2000 artifacts.
/// <br/><br/>**Required scope**: Tenant.ReadWrite.All
/// </remarks>
/// <param name='operations'>
/// The operations group for this extension method.
/// </param>
/// <param name='informationProtectionChangeLabelDetails'>
/// Set label details.
/// </param>
public static InformationProtectionChangeLabelResponse SetLabelsAsAdmin(this IInformationProtection operations, InformationProtectionChangeLabelDetails informationProtectionChangeLabelDetails)
{
return(operations.SetLabelsAsAdminAsync(informationProtectionChangeLabelDetails).GetAwaiter().GetResult());
}
/// <summary>
/// Set sensitivity labels on content in Power BI by artifact ID.
/// </summary>
/// <remarks>
/// **Note:** The user must have administrator rights (such as Office 365
/// Global Administrator or Power BI Service Administrator) to call this API.
/// <br/> To set a sensitivity label using this API, the admin user (or
/// the delegated user, if provided) must have the label included in their
/// [label
/// policy](https://docs.microsoft.com/en-us/microsoft-365/compliance/create-sensitivity-labels?view=o365-worldwide).
/// <br/> The admin user (and the delegated user, if provided) must have
/// sufficient [usage rights](https://go.microsoft.com/fwlink/?linkid=2157685)
/// to set labels.<br/>This API allows a maximum of 25 requests per hour.
/// Each request can update up to 2000 artifacts.
/// <br/><br/>**Required scope**: Tenant.ReadWrite.All
/// </remarks>
/// <param name='informationProtectionChangeLabelDetails'>
/// Set label details.
/// </param>
/// <param name='customHeaders'>
/// Headers that will be added to request.
/// </param>
/// <param name='cancellationToken'>
/// The cancellation token.
/// </param>
/// <exception cref="HttpOperationException">
/// Thrown when the operation returned an invalid status code
/// </exception>
/// <exception cref="SerializationException">
/// Thrown when unable to deserialize the response
/// </exception>
/// <exception cref="ValidationException">
/// Thrown when a required parameter is null
/// </exception>
/// <exception cref="System.ArgumentNullException">
/// Thrown when a required parameter is null
/// </exception>
/// <return>
/// A response object containing the response body and response headers.
/// </return>
public async Task <HttpOperationResponse <InformationProtectionChangeLabelResponse> > SetLabelsAsAdminWithHttpMessagesAsync(InformationProtectionChangeLabelDetails informationProtectionChangeLabelDetails, Dictionary <string, List <string> > customHeaders = null, CancellationToken cancellationToken = default(CancellationToken))
{
if (informationProtectionChangeLabelDetails == null)
{
throw new ValidationException(ValidationRules.CannotBeNull, "informationProtectionChangeLabelDetails");
}
if (informationProtectionChangeLabelDetails != null)
{
informationProtectionChangeLabelDetails.Validate();
}
// Tracing
bool _shouldTrace = ServiceClientTracing.IsEnabled;
string _invocationId = null;
if (_shouldTrace)
{
_invocationId = ServiceClientTracing.NextInvocationId.ToString();
Dictionary <string, object> tracingParameters = new Dictionary <string, object>();
tracingParameters.Add("informationProtectionChangeLabelDetails", informationProtectionChangeLabelDetails);
tracingParameters.Add("cancellationToken", cancellationToken);
ServiceClientTracing.Enter(_invocationId, this, "SetLabelsAsAdmin", tracingParameters);
}
// Construct URL
var _baseUrl = Client.BaseUri.AbsoluteUri;
var _url = new System.Uri(new System.Uri(_baseUrl + (_baseUrl.EndsWith("/") ? "" : "/")), "v1.0/myorg/admin/informationprotection/setLabels").ToString();
// Create HTTP transport objects
var _httpRequest = new HttpRequestMessage();
HttpResponseMessage _httpResponse = null;
_httpRequest.Method = new HttpMethod("POST");
_httpRequest.RequestUri = new System.Uri(_url);
// Set Headers
if (customHeaders != null)
{
foreach (var _header in customHeaders)
{
if (_httpRequest.Headers.Contains(_header.Key))
{
_httpRequest.Headers.Remove(_header.Key);
}
_httpRequest.Headers.TryAddWithoutValidation(_header.Key, _header.Value);
}
}
// Serialize Request
string _requestContent = null;
if (informationProtectionChangeLabelDetails != null)
{
_requestContent = Rest.Serialization.SafeJsonConvert.SerializeObject(informationProtectionChangeLabelDetails, Client.SerializationSettings);
_httpRequest.Content = new StringContent(_requestContent, System.Text.Encoding.UTF8);
_httpRequest.Content.Headers.ContentType = System.Net.Http.Headers.MediaTypeHeaderValue.Parse("application/json; charset=utf-8");
}
// Set Credentials
if (Client.Credentials != null)
{
cancellationToken.ThrowIfCancellationRequested();
await Client.Credentials.ProcessHttpRequestAsync(_httpRequest, cancellationToken).ConfigureAwait(false);
}
// Send Request
if (_shouldTrace)
{
ServiceClientTracing.SendRequest(_invocationId, _httpRequest);
}
cancellationToken.ThrowIfCancellationRequested();
_httpResponse = await Client.HttpClient.SendAsync(_httpRequest, cancellationToken).ConfigureAwait(false);
if (_shouldTrace)
{
ServiceClientTracing.ReceiveResponse(_invocationId, _httpResponse);
}
HttpStatusCode _statusCode = _httpResponse.StatusCode;
cancellationToken.ThrowIfCancellationRequested();
string _responseContent = null;
if ((int)_statusCode != 200)
{
var ex = new HttpOperationException(string.Format("Operation returned an invalid status code '{0}'", _statusCode));
if (_httpResponse.Content != null)
{
_responseContent = await _httpResponse.Content.ReadAsStringAsync().ConfigureAwait(false);
}
else
{
_responseContent = string.Empty;
}
ex.Request = new HttpRequestMessageWrapper(_httpRequest, _requestContent);
ex.Response = new HttpResponseMessageWrapper(_httpResponse, _responseContent);
if (_shouldTrace)
{
ServiceClientTracing.Error(_invocationId, ex);
}
_httpRequest.Dispose();
if (_httpResponse != null)
{
_httpResponse.Dispose();
}
throw ex;
}
// Create Result
var _result = new HttpOperationResponse <InformationProtectionChangeLabelResponse>();
_result.Request = _httpRequest;
_result.Response = _httpResponse;
// Deserialize Response
if ((int)_statusCode == 200)
{
_responseContent = await _httpResponse.Content.ReadAsStringAsync().ConfigureAwait(false);
try
{
_result.Body = Rest.Serialization.SafeJsonConvert.DeserializeObject <InformationProtectionChangeLabelResponse>(_responseContent, Client.DeserializationSettings);
}
catch (JsonException ex)
{
_httpRequest.Dispose();
if (_httpResponse != null)
{
_httpResponse.Dispose();
}
throw new SerializationException("Unable to deserialize the response.", _responseContent, ex);
}
}
if (_shouldTrace)
{
ServiceClientTracing.Exit(_invocationId, _result);
}
return(_result);
}
/// <summary>
/// Set sensitivity labels on content in Power BI by artifact ID.
/// </summary>
/// <remarks>
/// **Note:** The user must have administrator rights (such as Office 365
/// Global Administrator or Power BI Service Administrator) to call this API.
/// <br/> To set a sensitivity label using this API, the admin user (or
/// the delegated user, if provided) must have the label included in their
/// [label
/// policy](https://docs.microsoft.com/en-us/microsoft-365/compliance/create-sensitivity-labels?view=o365-worldwide).
/// <br/> The admin user (and the delegated user, if provided) must have
/// sufficient [usage rights](https://go.microsoft.com/fwlink/?linkid=2157685)
/// to set labels.<br/>This API allows a maximum of 25 requests per hour.
/// Each request can update up to 2000 artifacts.
/// <br/><br/>**Required scope**: Tenant.ReadWrite.All
/// </remarks>
/// <param name='operations'>
/// The operations group for this extension method.
/// </param>
/// <param name='informationProtectionChangeLabelDetails'>
/// Set label details.
/// </param>
/// <param name='cancellationToken'>
/// The cancellation token.
/// </param>
public static async Task <InformationProtectionChangeLabelResponse> SetLabelsAsAdminAsync(this IInformationProtection operations, InformationProtectionChangeLabelDetails informationProtectionChangeLabelDetails, CancellationToken cancellationToken = default(CancellationToken))
{
using (var _result = await operations.SetLabelsAsAdminWithHttpMessagesAsync(informationProtectionChangeLabelDetails, null, cancellationToken).ConfigureAwait(false))
{
return(_result.Body);
}
}