/// <summary>Snippet for PreviewRealmUpdate</summary>
public void PreviewRealmUpdateRequestObject()
{
// Snippet: PreviewRealmUpdate(PreviewRealmUpdateRequest, CallSettings)
// Create client
RealmsServiceClient realmsServiceClient = RealmsServiceClient.Create();
// Initialize request argument(s)
PreviewRealmUpdateRequest request = new PreviewRealmUpdateRequest
{
Realm = new Realm(),
UpdateMask = new FieldMask(),
PreviewTime = new Timestamp(),
};
// Make the request
PreviewRealmUpdateResponse response = realmsServiceClient.PreviewRealmUpdate(request);
// End snippet
}
/// <summary>Snippet for GetRealmAsync</summary>
public async Task GetRealmRequestObjectAsync()
{
// Snippet: GetRealmAsync(GetRealmRequest, CallSettings)
// Additional: GetRealmAsync(GetRealmRequest, CancellationToken)
// Create client
RealmsServiceClient realmsServiceClient = await RealmsServiceClient.CreateAsync();
// Initialize request argument(s)
GetRealmRequest request = new GetRealmRequest
{
RealmName = RealmName.FromProjectLocationRealm("[PROJECT]", "[LOCATION]", "[REALM]"),
};
// Make the request
Realm response = await realmsServiceClient.GetRealmAsync(request);
// End snippet
}
public void DeleteRealm(
string projectId, string regionId, string realmId)
{
// Create the client.
RealmsServiceClient client = RealmsServiceClient.Create();
DeleteRealmRequest request = new DeleteRealmRequest
{
RealmName = RealmName.FromProjectLocationRealm(projectId, regionId, realmId)
};
// Make the request.
Operation <Empty, OperationMetadata> response = client.DeleteRealm(request);
// Poll until the returned long-running operation is complete.
response.PollUntilCompleted();
}
public IList <Realm> ListRealms(
string projectId, string regionId)
{
// Create the client.
RealmsServiceClient client = RealmsServiceClient.Create();
ListRealmsRequest request = new ListRealmsRequest
{
ParentAsLocationName = LocationName.FromProjectLocation(projectId, regionId)
};
// Make the request.
PagedEnumerable <ListRealmsResponse, Realm> response = client.ListRealms(request);
// The returned sequence will lazily perform RPCs as it's being iterated over.
return(response.ToList());
}
/// <summary>Snippet for ListRealms</summary>
public async Task ListRealmsResourceNamesAsync()
{
// Snippet: ListRealmsAsync(LocationName, string, int?, CallSettings)
// Create client
RealmsServiceClient realmsServiceClient = await RealmsServiceClient.CreateAsync();
// Initialize request argument(s)
LocationName parent = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]");
// Make the request
PagedAsyncEnumerable <ListRealmsResponse, Realm> response = realmsServiceClient.ListRealmsAsync(parent);
// Iterate over all response items, lazily performing RPCs as required
await response.ForEachAsync((Realm item) =>
{
// Do something with each item
Console.WriteLine(item);
});
// Or iterate over pages (of server-defined size), performing one RPC per page
await response.AsRawResponses().ForEachAsync((ListRealmsResponse page) =>
{
// Do something with each page of items
Console.WriteLine("A page of results:");
foreach (Realm item in page)
{
// Do something with each item
Console.WriteLine(item);
}
});
// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page <Realm> singlePage = await response.ReadPageAsync(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Realm item in singlePage)
{
// Do something with each item
Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;
// End snippet
}
/// <summary>Snippet for ListRealms</summary>
public void ListRealms()
{
// Snippet: ListRealms(string, string, int?, CallSettings)
// Create client
RealmsServiceClient realmsServiceClient = RealmsServiceClient.Create();
// Initialize request argument(s)
string parent = "projects/[PROJECT]/locations/[LOCATION]";
// Make the request
PagedEnumerable <ListRealmsResponse, Realm> response = realmsServiceClient.ListRealms(parent);
// Iterate over all response items, lazily performing RPCs as required
foreach (Realm item in response)
{
// Do something with each item
Console.WriteLine(item);
}
// Or iterate over pages (of server-defined size), performing one RPC per page
foreach (ListRealmsResponse page in response.AsRawResponses())
{
// Do something with each page of items
Console.WriteLine("A page of results:");
foreach (Realm item in page)
{
// Do something with each item
Console.WriteLine(item);
}
}
// Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
int pageSize = 10;
Page <Realm> singlePage = response.ReadPage(pageSize);
// Do something with the page of items
Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
foreach (Realm item in singlePage)
{
// Do something with each item
Console.WriteLine(item);
}
// Store the pageToken, for when the next page is required.
string nextPageToken = singlePage.NextPageToken;
// End snippet
}
/// <summary>Snippet for PreviewRealmUpdateAsync</summary>
public async Task PreviewRealmUpdateRequestObjectAsync()
{
// Snippet: PreviewRealmUpdateAsync(PreviewRealmUpdateRequest, CallSettings)
// Additional: PreviewRealmUpdateAsync(PreviewRealmUpdateRequest, CancellationToken)
// Create client
RealmsServiceClient realmsServiceClient = await RealmsServiceClient.CreateAsync();
// Initialize request argument(s)
PreviewRealmUpdateRequest request = new PreviewRealmUpdateRequest
{
Realm = new Realm(),
UpdateMask = new FieldMask(),
PreviewTime = new Timestamp(),
};
// Make the request
PreviewRealmUpdateResponse response = await realmsServiceClient.PreviewRealmUpdateAsync(request);
// End snippet
}
/// <summary>
/// List realms
/// </summary>
/// <param name="projectId">Your Google Cloud Project Id</param>
/// <param name="regionId">Region in which the cluster will be created</param>
/// <returns>List all realms for project and region</returns>
public List <string> ListRealms(
string projectId = "YOUR-PROJECT-ID",
string regionId = "us-central1")
{
// Initialize the client
var client = RealmsServiceClient.Create();
// Construct the request
string parent = $"projects/{projectId}/locations/{regionId}";
// Call the API
try
{
var response = client.ListRealms(parent);
// Inspect the result
List <string> result = new List <string>();
bool hasMore = true;
Page <Realm> currentPage;
while (hasMore)
{
currentPage = response.ReadPage(pageSize: 10);
// Read the result in a given page
foreach (var realm in currentPage)
{
Console.WriteLine($"Realm returned: {realm.Name}");
result.Add(realm.Name);
}
hasMore = currentPage != null;
}
;
return(result);
}
catch (Exception e)
{
Console.WriteLine($"CreateRealm error:");
Console.WriteLine($"{e.Message}");
throw;
}
}
/// <summary>
/// Create a new realm
/// </summary>
/// <param name="projectId">Your Google Cloud Project Id</param>
/// <param name="regionId">Region in which the cluster will be created</param>
/// <param name="realmId"></param>
public string CreateRealm(
string projectId = "YOUR-PROJECT-ID",
string regionId = "us-central1",
string realmId = "YOUR-REALM-ID")
{
// Initialize the client
var client = RealmsServiceClient.Create();
// Construct the request
string parent = $"projects/{projectId}/locations/{regionId}";
string realmName = $"{parent}/realms/{realmId}";
var realm = new Realm
{
Name = realmName,
TimeZone = "America/Los_Angeles"
};
var request = new CreateRealmRequest
{
Parent = parent,
RealmId = realmId,
Realm = realm
};
// Call the API
try
{
var created = client.CreateRealm(request);
// Inspect the result
return($"Realm created for {realm.Name}. Operation Id {created.Name}");
}
catch (Exception e)
{
Console.WriteLine($"CreateRealm error:");
Console.WriteLine($"{e.Message}");
throw;
}
}
/// <summary>Snippet for CreateRealmAsync</summary>
public async Task CreateRealmRequestObjectAsync()
{
// Snippet: CreateRealmAsync(CreateRealmRequest, CallSettings)
// Additional: CreateRealmAsync(CreateRealmRequest, CancellationToken)
// Create client
RealmsServiceClient realmsServiceClient = await RealmsServiceClient.CreateAsync();
// Initialize request argument(s)
CreateRealmRequest request = new CreateRealmRequest
{
ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
RealmId = "",
Realm = new Realm(),
};
// Make the request
Operation <Realm, OperationMetadata> response = await realmsServiceClient.CreateRealmAsync(request);
// Poll until the returned long-running operation is complete
Operation <Realm, OperationMetadata> completedResponse = await response.PollUntilCompletedAsync();
// Retrieve the operation result
Realm result = completedResponse.Result;
// Or get the name of the operation
string operationName = response.Name;
// This name can be stored, then the long-running operation retrieved later by name
Operation <Realm, OperationMetadata> retrievedResponse = await realmsServiceClient.PollOnceCreateRealmAsync(operationName);
// Check if the retrieved long-running operation has completed
if (retrievedResponse.IsCompleted)
{
// If it has completed, then access the result
Realm retrievedResult = retrievedResponse.Result;
}
// End snippet
}
