docs: wrap samples with future prefix (#348)

security-center/snippets/v1/addDeleteSecurityMarks.js

@@ -18,6 +18,7 @@
  * marks from an asset.
  */
 function main(assetName = 'full asset path to add marks to') {
+ // [START securitycenter_add_delete_security_marks]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -44,6 +45,7 @@ function main(assetName = 'full asset path to add marks to') {
  }
  addDeleteSecurityMarks();
  // [END demo]
+ // [END securitycenter_add_delete_security_marks]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/addFindingSecurityMarks.js

@@ -17,6 +17,7 @@
  * Demostrates adding security marks to a finding.
  */
 function main(findingName = 'full finding path to add marks to') {
+ // [START securitycenter_add_finding_security_marks]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -44,6 +45,7 @@ function main(findingName = 'full finding path to add marks to') {
  }
  addFindingSecurityMarks();
  // [END demo]
+ // [END securitycenter_add_finding_security_marks]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/addSecurityMarks.js

@@ -18,6 +18,7 @@
  * Demostrates adding security marks to an asset.
  */
 function main(assetName = 'full asset path to add marks to') {
+ // [START securitycenter_add_security_marks]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -44,6 +45,7 @@ function main(assetName = 'full asset path to add marks to') {
  }
  addSecurityMarks();
  // [END demo]
+ // [END securitycenter_add_security_marks]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/createFinding.js

@@ -18,6 +18,7 @@
  * Demonstrates how to create a new security finding in CSCC.
  */
 function main(sourceName = 'FULL_PATH_TO_SOURCE_FOR_FINDING') {
+ // [START securitycenter_create_finding]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -56,6 +57,7 @@ function main(sourceName = 'FULL_PATH_TO_SOURCE_FOR_FINDING') {
  }
  createFinding();
  // [END demo]
+ // [END securitycenter_create_finding]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/createFindingSourceProperties.js

@@ -19,6 +19,7 @@
  * properties.
  */
 function main(sourceName = 'FULL_PATH_TO_SOURCE_FOR_FINDING') {
+ // [START securitycenter_create_finding_source_properties]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -61,6 +62,7 @@ function main(sourceName = 'FULL_PATH_TO_SOURCE_FOR_FINDING') {
  }
  createFinding();
  // [END demo]
+ // [END securitycenter_create_finding_source_properties]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/createNotificationConfig.js

@@ -18,6 +18,7 @@ function main(
  configId = 'your-config-name',
  pubsubTopic = 'projects/{your-project}/topics/{your-topic}'
 ) {
+ // [START securitycenter_create_notification_config]
  // [START scc_create_notification_config]
  // npm install @google-cloud/security-center/
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -46,6 +47,7 @@ function main(
 
  createNotificationConfig();
  // [END scc_create_notification_config]
+ // [END securitycenter_create_notification_config]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/createSource.js

@@ -18,6 +18,7 @@
  * createSource demonstrates how to create a new security finding source.
  */
 function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
+ // [START securitycenter_create_source]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -41,6 +42,7 @@ function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
  }
  createSource();
  // [END demo]
+ // [END securitycenter_create_source]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/deleteNotificationConfig.js

@@ -14,6 +14,7 @@
 'use strict';
 
 function main(organizationId = 'your-org-id', configId = 'your-config-id') {
+ // [START securitycenter_delete_notification_config]
  // [START scc_delete_notification_config]
  // npm install @google-cloud/security-center/
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -34,6 +35,7 @@ function main(organizationId = 'your-org-id', configId = 'your-config-id') {
 
  deleteNotificationConfg();
  // [END scc_delete_notification_config]
+ // [END securitycenter_delete_notification_config]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/deleteSecurityMarks.js

@@ -18,6 +18,7 @@
  * Demostrates deleting security marks on an asset.
  */
 function main(assetName = 'full asset path to add marks to') {
+ // [START securitycenter_delete_security_marks]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -44,6 +45,7 @@ function main(assetName = 'full asset path to add marks to') {
  }
  deleteSecurityMarks();
  // [END demo]
+ // [END securitycenter_delete_security_marks]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/enableAssetDiscovery.js

@@ -18,6 +18,7 @@
  * Demostrates enabling asset discovery for an organization.
  */
 function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
+ // [START securitycenter_enable_asset_discovery]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -45,6 +46,7 @@ function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
  }
  updateOrgSettings();
  // [END demo]
+ // [END securitycenter_enable_asset_discovery]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/getNotificationConfig.js

@@ -14,6 +14,7 @@
 'use strict';
 
 function main(organizationId = 'your-org-id', configId = 'your-config-id') {
+ // [START securitycenter_get_notification_configs]
  // [START scc_get_notification_configs]
  // npm install @google-cloud/security-center/
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -36,6 +37,7 @@ function main(organizationId = 'your-org-id', configId = 'your-config-id') {
 
  getNotificationConfg();
  // [END scc_get_notification_configs]
+ // [END securitycenter_get_notification_configs]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/getOrganizationSettings.js

@@ -19,6 +19,7 @@
  * includes the current status of asset recovery.
  */
 function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
+ // [START securitycenter_get_organization_settings]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -41,6 +42,7 @@ function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
  }
  getOrgSettings();
  // [END demo]
+ // [END securitycenter_get_organization_settings]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/getSource.js

@@ -19,6 +19,7 @@
  * source.
  */
 function main(sourceName = 'FULL_PATH_TO_SOURCE') {
+ // [START securitycenter_get_source]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -37,6 +38,7 @@ function main(sourceName = 'FULL_PATH_TO_SOURCE') {
 
  getSource();
  // [END demo]
+ // [END securitycenter_get_source]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/getSourceIam.js

@@ -18,6 +18,7 @@
  * Demostrates retrieving the current IAM policy for a source.
  */
 function main(sourceName = 'FULL_PATH_TO_SOURCE') {
+ // [START securitycenter_get_source_iam]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -40,6 +41,7 @@ function main(sourceName = 'FULL_PATH_TO_SOURCE') {
  }
  getSourceIamPolicy();
  // [END demo]
+ // [END securitycenter_get_source_iam]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/listAllAssets.js

@@ -16,6 +16,7 @@
 
 /** Prints all assets in an organization. */
 function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
+ // [START securitycenter_list_all_assets]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -43,6 +44,7 @@ function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
 
  listAssets();
  // [END demo]
+ // [END securitycenter_list_all_assets]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/listAllFindings.js

@@ -16,6 +16,7 @@
 
 /** Prints all findings across all sources. */
 function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
+ // [START securitycenter_list_all_findings]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -42,6 +43,7 @@ function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
  }
  listAllFindings();
  // [END demo]
+ // [END securitycenter_list_all_findings]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/listAllSources.js

@@ -16,6 +16,7 @@
 
 /** Prints all sources in an organization. */
 function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
+ // [START securitycenter_list_all_sources]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -40,6 +41,7 @@ function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
 
  listSources();
  // [END demo]
+ // [END securitycenter_list_all_sources]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/listAssetsAndChanges.js

@@ -19,6 +19,7 @@
  * days ago.
  */
 function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
+ // [START securitycenter_list_assets_and_changes]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -51,6 +52,7 @@ function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
 
  listAssetsAndChanges();
  // [END demo]
+ // [END securitycenter_list_assets_and_changes]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/listAssetsAtTime.js

@@ -18,6 +18,7 @@
  * Prints project assets for the organization as of yesterday.
  */
 function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
+ // [START securitycenter_list_assets_at_time]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -59,6 +60,7 @@ function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
 
  listAssetsAtTime();
  // [END demo]
+ // [END securitycenter_list_assets_at_time]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/listAssetsWithSecurityMarks.js

@@ -18,6 +18,7 @@
  * Prints assets with security mark of key_a == value_a.
  */
 function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
+ // [START securitycenter_list_assets_with_security_marks]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -49,6 +50,7 @@ function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
 
  listAssetsWithSecurityMarks();
  // [END demo]
+ // [END securitycenter_list_assets_with_security_marks]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/listFilteredAssets.js

@@ -18,6 +18,7 @@
  * Prints current project assets for the organization.
  */
 function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
+ // [START securitycenter_list_filtered_assets]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -50,6 +51,7 @@ function main(organizationId = 'YOUR_NUMERIC_ORG_ID') {
 
  listFilteredAssets();
  // [END demo]
+ // [END securitycenter_list_filtered_assets]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/listFilteredFindings.js

@@ -16,6 +16,7 @@
 
 /** Demonstrates listing only specific findings. */
 function main(sourceName = 'YOUR_NUMERIC_ORG_ID') {
+ // [START securitycenter_list_filtered_findings]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -44,6 +45,7 @@ function main(sourceName = 'YOUR_NUMERIC_ORG_ID') {
  }
  listFilteredFindings();
  // [END demo]
+ // [END securitycenter_list_filtered_findings]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/listFindingsAtTime.js

@@ -16,6 +16,7 @@
 
 /** Demonstrates listing findings at a point in time. */
 function main(sourceName = 'FULL RESOURCE PATH TO PARENT SOURCE') {
+ // [START securitycenter_list_findings_at_time]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -50,6 +51,7 @@ function main(sourceName = 'FULL RESOURCE PATH TO PARENT SOURCE') {
  }
  listFindingsAtTime();
  // [END demo]
+ // [END securitycenter_list_findings_at_time]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/listFindingsWithSecurityMarks.js

@@ -16,6 +16,7 @@
 
 /** Demonstrates listing findings by filtering on security marks. */
 function main(sourceName = 'YOUR_NUMERIC_ORG_ID') {
+ // [START securitycenter_list_findings_with_security_marks]
  // [START demo]
  // Imports the Google Cloud client library.
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -44,6 +45,7 @@ function main(sourceName = 'YOUR_NUMERIC_ORG_ID') {
  }
  listFindingsWithSecurityMarks();
  // [END demo]
+ // [END securitycenter_list_findings_with_security_marks]
 }
 
 main(...process.argv.slice(2));

security-center/snippets/v1/listNotificationConfigs.js

@@ -14,6 +14,7 @@
 'use strict';
 
 function main(organizationId = 'your-org-id') {
+ // [START securitycenter_list_notification_configs]
  // [START scc_list_notification_configs]
  // npm install @google-cloud/security-center/
  const {SecurityCenterClient} = require('@google-cloud/security-center');
@@ -33,6 +34,7 @@ function main(organizationId = 'your-org-id') {
 
  listNotificationConfigs();
  // [END scc_list_notification_configs]
+ // [END securitycenter_list_notification_configs]
 }
 
 main(...process.argv.slice(2));